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How To Use This Manual 


introduction 


The HP-71 Reference Manual is a reference tool for users who are already familiar with HP-71 oper- 
ation and BASIC language programming. If you are new to the HP-71, you should first turn to the 
HP-71 Owner’s Manual to familiarize yourself with the computer’s features. 


This manual provides a source of nontutorial information concerning HP-71 keywords, character sets, 
memory requirements, error messages, and other topics. Included also are a glossary of HP-71 terms 
(page 346), a Keyword Summary and Index (page 394), and a Subject Index (page 406). 


The HP-71 Keyword Dictionary covers keyword use, syntax, parameter guidelines, operating details, 
and related keywords. Before you begin referring to the dictionary, read through the information on the 
next four pages to familiarize yourself with the dictionary’s format and use. 


What Is a Keyword? 


The term keyword refers to your HP-71’s BASIC statements, functions, and operators. All but nine of 
the keywords are programmable. These nine are termed nonprogrammable statements. (In some com- 
puter literature, such nonprogrammable keywords are referred to as commands.) 


Finding Keyword Entries 


The HP-71 keyword entries are placed in alphabetical order. Each entry begins at the top of a new page 
and can be quickly identified by the keyword name printed in large, blue characters. The keywords for 
some trigonometric functions have acceptable alternate spellings. Such alternates are indicated in 
parentheses at the top of the page, following the more common spelling. Middle keywords, such as Tl, 
cannot be executed alone and therefore are not listed separately. 


Combined Keyword Descriptions. Where two or more keyword entries begin with the same word(s) 
and perform similar operations, their descriptions are grouped together under one heading. For exam- 
ple, OH ERROR GOSUB and OH ERROR GOTO are described under the page heading ON ERROR 
GOSUB / GOTO. In these instances, common features such as identical input parameters are repre- 
sented once for all keywords in the group. 


Operator Descriptions. Logical operators (AHO, EOF, HOT, and OF) appear in alphabetical order 
in the Keyword Dictionary. The @ character, the #: concatenation operator, and the math operators (+, 
~, #, “, X, and *) appear at the end of the dictionary. Relational operators (“, =, 2, #, 7, 2=, +=, and 
<>) are listed under “Precedence of Operators” on page 317, but do not appear in the Keyword 
Dictionary. 
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Format for Keyword Dictionary Entries 


Each of the numbered circles shown below links a feature of the Keyword Dictionary format to a 
corresponding illustration in the sample dictionary entry on the facing page. 


Gd) Keyword Name: Identifies the keyword entry and includes, within parentheses, the keyword’s 
acceptable alternate spelling, if any. 


@) Purpose: Describes what operations the keyword is designed to perform. If the keyword is one of 
the niné nonprogrammable statements, this fact is noted in this description. 


(3) Keyword Type and Execution Options: The filled-in squares (gj) in this chart indicate the 
keyword type (statement, function, or operator) and whether you can execute the keyword from the 
keyboard, in CALC mode, and/or after THEH or ELSE in an IF... THEN... ELSE statement. 


@ Syntax Diagram: [Ilustrates the required and optional syntax for HP-71 keywords. A description 
of how to read the syntax diagrams is provided on page 8 (following the sample of the DI SF 
dictionary entry). 


G) Examples: Illustrate some of the different ways you can use the keyword. (The examples are sepa- 
rate from each other and, unless otherwise indicated, should not be read as if they are part of the 
same instruction.) Examples that use quoted strings are shown with pairs of double quotes 
("..."). Except in the case of quotes within quotes ("' ... '"), or where a pair of double quotes 
enclose one single quote ("...' ..."), a pair of single quotes (' ... ') can be used in place of a 
pair of double quotes. 


6) Input Parameters Table: Further specifies the parameters used in the syntax diagram. 


Note: The various types of input parameters referred to in the syntax diagrams and “Input 
Parameters” tables are defined in the glossary. 


@ Comments: Additional information about the use of the keyword. 


Related Keywords: Other keywords that have either a functional similarity to the keyword being 
described or an influence on its results. 
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DISP 





{it displays numeric and string data. 








H Statement @ Keyboard Execution 
O Function O CALC Mode 
O Operator @ iF...THEN...ELSE 








Input Parameters 























| Item Description Restrictions 
expression Numeric or string expression. None. 
column Numeric expression rounded to an integer. | Greater than zero. 
Comments 





You can omit the statement name itself in all cases except immediately after 


Related Keywords 


DiSF USING, EWG, FIS, PETHT, SCI, STO, STES, WIDTH. 
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How To Read the Syntax Diagrams 


The diagrams indicate acceptable keyword input syntax. (Incorrect syntax in an input prevents the 
computer from accepting that input, which results in an error message.) 


Note: The syntax diagrams illustrate the general use of blanks in keyword inputs. For a more 
detailed discussion of this topic, refer to “Using Blanks in Keyword Inputs,” on the next page. 


Double quotes are used in these diagrams. However, you can also use single quotes. (The opening and 
closing quote symbols must match.) 


Example. 






Gas) +O) —+fsiem} +) 


e Items enclosed in ovals and circles can be entered in either uppercase or lowercase letters. Blanks 
should not be embedded unless explicity shown. 


e Items in the boxes correspond directly to entries in the “Item” column of the “Input Parameters” 
table included in the keyword description. 


e All valid paths through the diagrams are indicated by arrows. Looping paths indicate a parameter 
or sequence that can be repeated. 


e An item is optional if there is a valid path around it. Options are generally shown as descending 
loops. 

e An arrow (——) terminating the exit path from a statement indicates that you can use the @ 
character to append another statement to the illustrated statement. 


e An arrow and an “X” (——»xX ) terminating the exit path from a statement indicates that no 
statement can be appended after the subject statement. 


e An arrow with a vertical bar (——»4) used to terminate the exit path from a statement indicates 
that other statements can be appended, but they will not be executed following execution of the 
illustrated statement. 
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Using Blanks in Keyword Inputs 


You can use blanks as separators between keywords, parameters, and punctuation unless otherwise 
indicated in a keyword entry. However, blanks are not needed as separators except where required by 
the HP-71 to prevent misinterpretation or error conditions when processing a keyword input. 


The HP-71 uses blanks as delimiters for unquoted strings. Without these delimiters, using an 
unquoted string for an input such as a file type name or an unquoted file specifier can cause an error. 
For example, the HP-71 accepts file type names having up to five characters. Thus, to tell the com- 
puter to “create file ABC of type TEXT,” you would use the statement 


Tr oT “ 
fet SE 3 





which the HP-71 interprets as “create file BC of type TEXTA” (which is a nonexistent type). This 
second interpretation results in an error message because there is no such file type. Similarly, if you 


wanted your HP-71 to copy file Fi to file E, you would enter COF ‘ss A TO &. (Using the same state- 
ment without blanks—(C OF '‘ATO&—tells the computer to copy file RTE to main RAM.) 


Ambiguity in program statements can also occur in certain uses of an unquoted file specifier that con- 
tains a device specifier. For example, to tell the computer to copy file A from a plug-in device to file &, 
you would use a program statement such as 


100 COPY A:PORT TO B 
which must have blanks, as shown. Omitting the blanks results in the statement 


100 COPYA:PORTTOB 


statement (as interpreted) does not contain a valid statement, an error results. 


Using the Glossary 


The Glossary (page 346) describes the terminology used in this manual and in your HP-71 Owner’s 
Manual, and includes syntax diagrams that illustrate some of the common terms used in the keyword 
dictionary to specify keyword inputs. 


Using the Keyword Index 


The keyword index, which begins on page 394, provides you with both a reference for locating keywords 
by page number and a listing of keywords by functional category (such as “Input/Out” statements and 
“File Management” statements). 





HP-71 Keyword Dictionary 


ABS 








REVS ¢s returns the value of « with its sign set to “+.” 
O Statement @ Keyboard Execution 
M@ Function HM CALC Mode 
() Operator @ IF...THEN...ELSE 
Ge )}—-© © 
Examples 





Input Parameters 





Description Restrictions 








= +0 
= NaN, with its sign field forced to +. 


Related Keywords 





10 


11 
ACOS (ACS) 


£1 (arccosine) returns the principal value of the angle having a cosine equal to its argument. The 
angle returned is expressed in the current angular setting. 







Oh Statement 
® Function 
O Operator 


Keyboard Execution 
CALC Mode 
IF... THEN... ELSE 










Numeric expression. —1 through 1. 





Angular Range of 
You can change the angular setting by executing DEGREES (when in Setting ACOS 
Radians setting), or FAD IAHS (when in Degrees setting). Refer also Degrees 0 through 180 
to the OF TIOH statement. Radians 0 through PI 





Related Keywords 


H, FITAM, ATH, COS, OES, 
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ADD 


FiO adds the coordinates of a data point to the summary statistics in the current statistical array. 


mM Statement HM Keyboard Execution 
O Function [O CALC Mode 


(1 Operator @ IF...THEN...ELSE 












eat 


Examples 


' 


(OG ROO 1, 34.8 


o 





GI 


oT 
tm 


Input Parameters 


ee 
coordinate Numeric expression giving coordinate 

(value) of the data point. 
Comments 


Numeric expressions you specify when you execute Fil! represent the coordinates (values) of the data 
point. The number of expressions must be within the range specified by a preceding 277 statement 
(0 through 15). Any missing coordinates are assumed equal to zero. 












Related Keywords 





fR, ILOTAT, OR OF, LE, MI 
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ADDR$ 


HOOF (address string) returns a string representing the hexadecimal address of the file you specify. 





O Statement HM Keyboard Execution 
@ Function C1 CALC Mode 
O Operator M@ IF...THEN...ELSE 
o o 
Examples 
A#=AODRS C*FTLEL? 3 QDISP RAOORS "FILES: FORT" & 


Input Parameters 


ee ee 
file specifier String expression containing a file File name with optional port 
specifier. specifier. 


Comments 





AOGE+ returns the address of the beginning of the file header. 


Related Keywords 


QOTH#, HTO, PEER, FORE. 





p 
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ADJABS 


AOWAES (adjust-absolute) performs an absolute adjust on the system clock. 


@ Statement 


M Keyboard Execution 
O) Function {1 CALC Mode 
QO Operator @ iIF...THEN...ELSE 








FRET} 
string 
Examples 
AOJABS 124.7 ADJABS "4+8e:a5:45" ADJABS AF 
ADJABS -33ae ADJABS "“-G@G:@e:i4" 
ADJABS “ga:a3:35" ADJABS H 


Input Parameters 


Pte [ene 


seconds Seconds (s) in the range —360000 
< s < 360000. 


Maximum of 99° 59™ 598. 





Numeric expression. 













adjustment string String expression in form "HH: MM: 


SS" or "-HH: MM: SS." 





Comments 


FCLIAES changes only the HP-71’s clock time; the current clock speed is not affected. To adjust both 
the clock time and the clock speed, refer to the ALi.tLi= 7 statement on the next page. 


Related Keywords 


ADJUST, AF, EXACT, SETTIME. 
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ADJUST 





AG :T simultaneously changes the clock time and specifies a clock speed correction that is stored 


M@ Statement M@ Keyboard Execution 








O Function MO CALC Mode 
Ol Operator @ iF...THEN...ELSE 
EY 
string 
Examples 
ADJUST ed. 7 ACJIUST “+e: Ba: 45! ADS TH 
AOJUST -ZS88 ADJUST "-8G; 82:14" 
AGIUST "Ge: 8S: 35" AGIUST AF 


Input Parameters 


Seconds (s) in the range —360000 
< s < 360000. 


Maximum of 99" 59™ 598, 






seconds Numeric expression. 








- adjustment string String expression of form "HH: MM: 


SS" or "-HH: MM: SS". 





Comments 


ACLU T performs the following: 
1. Changes the clock time by the amount you specify. 


2. Stores the difference between amount you specify and the nearest multiple of 30 minutes as an 
error correction that will be implemented the next time you execute EXACT. 
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ADJUST (continued) 


Relative Clock Adjustment 


o™ 30™ 60™ 90™ 


Ee ae oie eee Lae eee ere 


te 


ee —-—— 


+d 


ee > 
Relative Adjustment 


om 30™ 60™ go™ 
lie iS lee sities l= SH ll tahoe 
SS 


———S_ 


Relative Adjustment -—d 


Executing HONUST performs the relative clock adjust- 
ment and stores d as data for E*ACT correction factor 
computation. 


Because the error correction is added to any error correction already stored as a result of earlier 
executions of ALNJLIST, you can execute AL.JLIST as many times as you want to before executing 
EXACT. EXACT uses the accumulated error correction, then clears it from memory. 


ADJUST . ; 
Time Change Error Correction 
Input 


— 3300 —55" +5™ (Measured from —60™ to —55™.) 
+3™ 358 (Measured from 00™ to 3™ 358.) 
—2™ 148 (Measured from 00™ to —02™ 
148.) 


00:03:35 + 37 358 
—00:02:14 — 2™ 14§ 





If you execute Al.Jl!S7T more than once before executing EXACT, the corresponding error correc- 
tions are accumulated. 


The resolution of the clock system is 0.0019° (1/512th of a second). Numeric input for AUJUST can 
specify fractional seconds; string input cannot. 


Related Keywords 


AQDJABS, AF, EsACT, SETTINE. 
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AF 


FiF returns the current value of the clock system adjustment factor (expressed in seconds), and gives 
you the option of setting a new adjustment factor. 






| Ol Statement M Keyboard Execution 
| @ Function M@ CALC Mode 
Ol Operator @ iF...THEN...ELSE 


new adjustment 
factor 





Examples 


LET #& = AF O1SF AF LET ‘ = AF C1eees 


il 


Input Parameters 


new adjustment Numeric expression rounded to an 
factor (in seconds) | integer. 


Must be either 0 or within one of 
the following ranges: 


e 10 <= new af <= 8,388,607. 


¢ —8,388,608 <= new af <= 
—10. 





Comments 


If you specify a new adjustment factor with HF, that factor replaces the current adjustment factor in 
the HP-71’s clock. However, regardless of whether you specify a new adjustment factor, AF always 
returns the current adjustment factor. 


The HP-71 adjusts the clock’s internal time base by applying a 1-second correction at the intervals 
specified by the adjustment factor. A positive AF adds the correction; a negative AF subtracts the 
correction. Specifying a new adjustment factor in the range of either 1 <= new af <= 9 or —9 <= 
new af <= —1 results in an Invalid AF (error 27) message. Specifying new af > 8,388,607 or 
new af < —8,388,608 defaults the new adjustment factor to 0. 
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AF (continued) AND 
Related Keywords FAME returns a 1 or a 0, based on the logical AND of its operands. 
ERACT - 
Ol Statement M Keyboard Execution 
' © Function M CALC Mode 
_ Operator @ IF...THEN...ELSE 
(ne) 
Examples 
IF 2 = 2S AHO A = € THEN GOSUE 188 
O = F AHO 5 











Comments 


The operands of AHE are considered to be logically false ° 
if zero and logically true if nonzero. The table to the right perand 


indicates the range of results for HHO. Left | Right 


The precedence of AHL in relation to the HP-71’s other 
operators is described under “Precedence of Operators” 
on page 317. 





Related Keywords 


EXOR, HOT, OF. 
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ANGLE 


AHGLE returns the polar angle determined by the (x,y) coordinate pair. The angle returned is ex- 
pressed according to the current angular setting. 





Ol Statement M@ Keyboard Execution 
@ Function @ CALC Mode 
C1 Operator @ IF...THEN...ELSE 
© o o 
Examples 
T = AHGLE cc, *o 


Input Parameters 


a 


Numeric expression representing first 
coordinate of pair (x,y). 


Numeric expression representing second 
coordinate of pair (x,y). 








x-argument 














y-argument 
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ANGLE (continued) 


Comments 


The arguments need not both be finite. (Notice, however, that there are invalid argument pairs. For 
example, ANGLE «INF. INF > is invalid.) Certain cases distinguish the sign of a zero argument. The 
range of AHGLE is shown in the following illustration. 


Range of Degrees Setting: — 180° through 180° 
Range of Radians Setting: — through z 


90° or 7/2 
y 
180° or 7 x 0° or 0 
—180° or —7 
—90° or —2/2 
Where s(a) = sign(a)—except for s(+0) = 1 and s(—0) = —1—the following table defines 


AHGLE Cx ys. 


Normal Inputs 


ANGLE <x, y? 


+0 y 

Any Number  ATAN(y/x) 

s(y) = 1 ATAN(y/x) + 180 (in Degrees setting) 
s(y) = —1 ATAN(y/x) — 180 (in Degrees setting) 





Related Keywords 
ACOS, ACS, ASIM, ASH, ATAH, ATH, COS, DEG, DEGREES, OPFTIOM, RAD, RADIANS, 
SIH, TAN. 
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ASIN (ASN) 


21H (arcsine) returns the principal value of the angle having a sine equal to its argument. The angle 
returned is expressed in the current angular setting. 





OO Statement M Keyboard Execution 
@ Function M@ CALC Mode 
Ol Operator @ iF...THEN...ELSE 


















argument 


Examples 


PRIHT ASTH CAeR 2 


Input Parameters 


argument Numeric expression. 


Comments 










—1 through 1. 


Angular Range of 
Setting ASIN 


Degrees —90 through 90 
Radians —PI/2 through Pl/2 








You can change the angular setting by executing DEGREES 
(when in Radians setting) or RANTANS (when in Degrees 
setting). Refer also to the OP TIOH statement. The range of 
the result of ASIH is shown in the table to the right. 





Related Keywords 


ACOS, ACS, ANGLE, ATAH, ATH, ASH, COS, DEG, DEGREES, GOFTIOH, RAD, RAOTANS, 
SIH, TAH. 
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ASSIGN # 


ASS1GH # associates a symbolic channel number with a specified file and opens that file. 


M@ Statement M Keyboard Execution 


1 Function Ol CALC Mode 
© Operator mM iIF...THEN...ELSE 





So 






Examples 
ASSIGN #1 TO FILE1 ASSIGN #6 TO * 
ASSIGN #L TOFILEZ:PORT (23 ASSIGN #6To"" 


Input Parameters 


Numeric expression rounded to an 
integer. 


Restrictions 

















channel number 1 through 255. 









file specifier String expression or unquoted string. File name with optional device 
specifier. Cannot reference CARD 


device. 
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ASSIGN # (continued) 


Comments 


A given channel can be assigned to only one file at a time. Thus, if you specify a channel that is already 
assigned to another file, that file is closed and the channel is then assigned to the new file. 


An assigned channel is automatically released, and its associated file closed, by assigning the channel 
number to #, "#", or *". Also: 
e Executing FH or EMO ALL releases all channels. 
e Executing EMC or TOF, or encountering the end of the program releases all channels in the 
local environment. 


e Executing EHO SUE releases only those channels local to the subprogram. 


If ASSIGH # specifies a file, but no device, and cannot find the file, the HP-71 creates a DATA file (of 
size zero, with a 256-byte record length) in main RAM and gives this file the name specified by 
ASSIGH #. However, if ASSI1GH # specifies a file and a device, but the file cannot be found on this 
device, an error condition occurs. 


Related Keywords 
CREATE. 
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ATAN (ATN) 


TAH (arctangent) returns the principal value of the angle having a tangent equal to its argument. 
The angle returned is expressed in the current angular setting. 





O Statement M Keyboard Execution 
@ Function ™@ CALC Mode 
C1 Operator @ IF...THEN...ELSE 















Numeric expression. —INF through INF. 


' argument 








Comments 
Ye h ] i ing DEGREES 

ou can c ange the angu ar ene by erecuns EGRE Angular Range of 
(when in Radians setting) or FAD IAHS (when in Degrees Setting ATAN 
setting). Refer also to the AF TICH statement. The range of 


the result of HTAH is shown in the table to the right. Degrees ~90 through 90 


Radians —PI/2 through PI/2 





Related Keywords 


RTM, COS, EG, DEGREES, OF TION, RAD, RAD TRAHS, 
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AUTO 


ALTO begins automatic line numbering for editing the current file, and is nonprogrammable. 





M@ Statement ®@ Keyboard Execution 
M1 Function [1 CALC Mode 
Ol Operator @ if...THEN...ELSE 








rE 


line number 


Examples 





FA 


Input Parameters 








start line number Integer constant identifying a program 1 through 9999. 
line. 
Default: 10. 
increment Integer constant. 1 through 9999. 
Default: 10. 
Comments 
ITC) numbers new program lines as they are entered and stored. Automatic numbering begins with 


the start line number and continues with the specified or default increment. If an automatically dis- 
played line number corresponds to an existing line in program memory, that line is displayed. If the 
current line number added to the increment value exceeds 9999, a wrap-around takes place. That is: 


Next Line Number = (Current Line Number + Increment) — 9999 - 
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AUTO (esniiiusdy 


Any one of the following operations terminates | 





operation: 


® Typing over the displayed line number with a syntactically correct line that does not begin with a 
line number, then pressing [END LINE]. 


¢ Deleting the line by pressing when the display following the line number is blank. 
¢ Pressing [ATTN]. 
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BEEP, BEEP OFF/ON 


GFF disables the 





causes a tone to sound at the specified frequency and duration. F 
beeper. REEF OH enables the beeper. 


mM Statement M@ Keyboard Execution 
Ol Function O CALC Mode 
Ol Operator BM IF...THEN...ELSE 








Examples 
BEEF ow 
BEEP F 





Input Parameters 


Numeric expression rounded to an 
integer. 
Default: 500 Hz. 


Numeric expression rounded to the nearest 
thousandth. 
Default: 0.25 seconds. 









Restrictions 














frequency Refer to ‘‘Comments,”’ below. 








duration D <= 1048.575 seconds. 





Comments 


The beeper has two volume settings; normal (default) and loud. You can switch the volume to a loud 
tone by setting flag —25 (the system beep volume flag). Clearing flag —25 returns the beep volume to 
its normal (default) level. 
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BEEP, BEEP OFF/ON (continued) 


BEEP Statement. The frequency of the tone is subject to the resolution of the built-in tone gener- 
ator. The maximum frequency is approximately 4900 Hz. A specified duration greater than the maxi- 
mum indicated under “Restriction” on the preceding page defaults to the maximum. 


BEEP OFF Statement. EEEF (FF deactivates the beeper by setting flag —2 (the beep flag). 
When deactivated, the beeper does not operate for any purpose, including execution of BEEF. 


Note: After executing EEEF &FF,a tone does not sound when the HP-71 detects an error condi- 
tion. 


BEEF GFF does not affect the current setting of the beep volume flag (flag —25). 


BEEP ON Statement. EEEF +H activates the beeper by clearing flag —2 (the Beep flag). BEEF 
tiH does not affect the current setting of flag —25 (the beep volume flag). 
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BYE CALL 













BYE turns off the HP-71. CALL transfers program execution to a specified subprogram and may also pass parameters to that 
subprogram. 
M@ Statement MM Keyboard Execution = | QM => 
O Function 1 CALC Mode Mm Statement ™ Keyboard Execution 
CO Operator @ IF... THEN... ELSE QO Function Cl CALC Mode 








O Operator @ iF...THEN...ELSE 





BYE 
Examples eee ee 
a Emp 
Comments 
General Operation. Pressing after executing EE turns on the HP-71. Executing E'’E ina Examples 
program causes the HP-71 to automatically resume execution of the program—at the instruction fol- 
lowing E'yE—when the computer is turned on again. However, when executing EE from the key- CALL 
board, any statements concatenated after E''E are not executed when the computer is turned on CALL SETUP 
rears CALL CICA, BS. 844, "VES") 
Timer Control of Program Execution. If the HP-71 activates a timer by executing OH TIMER, CALL COMTROLCALC43, Po, te TH ICSuES 
then subsequently executes £:\'E, the computer turns itself off as described above. However, when the CALL “EXECUTE <CL: 
CALL SECUTE"€ cba, &, 








timer expires, the computer turns on, executes the branch indicated by the timer, then continues 
executing the program. 


Related Keywords 


OFF. 
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CALL (continued) 


Input Parameters 


mee 


Quoted or unquoted string. 


One to eight characters. The first 
character must be a letter; any remain- 
ing characters can be letters and/or 
digits in any combination. 













subprogram name 












string variable Refer to Glossary. Must evaluate to subprogram name. 


name 













Expressions cannot reference user- 
defined functions. Rounded value of a 
channel expression must be n the 
range of 1 through 255. 


Constant, expression, variable name, 
or channel expression (numeric ex- 
pression preceded by #). 


actual parameter 




















File name, with optional memory 
device specifier (:MAIN or :PORT). Ex- 
pressions cannot reference user- 
defined functions. 


file specifier String expression or unquoted string 


Comments 


A subprogram may call itself. User-defined functions may not appear anywhere in the parameter list. 


Passing Parameters. 


e The parameters must be of the same type (numeric, string, or channel number) as the correspond- 
ing parameters in the subprogram’s 51/E statement. 


e Numeric expressions are passed by value to the corresponding numeric variable. 
e A numeric variable may be passed by value by enclosing it in parentheses. 


e An array passed by reference may have «? or «, % following the variable name indicating the 
number of dimensions (1 or 2) of the passed array. However, the “ or ©, 3 is necessary only in 
the =UIE parameter list. 


e String expressions or substrings are passed by value (up to a maximum length of 32 characters). 


e String variables can also be passed by reference. 
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CALL (continued) 


A channel number in the actual parameter list is a # followed by an integer constant or a numeric 
expression. However, the corresponding formal parameter must be a # followed by an integer con- 
stant. A channel number opened by a subprogram (and not passed as a parameter) is local to the 
subprogram. If a subprogram has no parameter list, then the subprogram’s channel numbers are the 
same as those for the calling program, but all variables are local to the subprogram. 


Note: Because of this feature, if the subprogram takes no parameters due to an omission in CA 
=LIE, you may unexpectedly discover channel numbers intended for local use are being used by 
the calling program. 








Subprograms. You can enter more than one subprogram in a program file. A subprogram must start 
with =/£ and end with EHE U6. Any program lines between two subprograms will not be ex- 
ecuted in normal program flow. You can store subprograms in the same file as a main program, as long 
as the the main program precedes any subprograms. It is recommended that you use a different name 
for each of your subprograms. Otherwise, there is a possibility that one of two or more commonly- 
named subprograms will always be called, regardless of your intent, while any other subprograms hav- 
ing that name will not be found by the computer. 





The HP-71 searches for a subprogram as follows: 
1. The current program file. 


2. Any other program files in HP-71 memory, in the order in which they appear in the system 
catalog. 


3. Program files in any plug-in memory modules, in port number order. 





4. If the subprogram is not found, and (FLL passes no parameters, then the subprogram name is 
searched for as a program file name. (If a file name is specified by the I} keyword, as shown in 
the syntax diagram on page 31, only that file will be searched.) 


Executing {ALL creates a local environment* for the subprogram. (That is, a new set of variables is 
created which does not disturb the old variables unless they were passed as parameters). When execu- 
tion returns from the subprogram to the calling program, the HP-71 reactivates the calling program’s 
environment. ‘ 


* For further information concerning local and global environments, refer to “Scope of Environments” on page 314, and to your 
HP-71 Owner’s Manual. 
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CALL (continued) CAT 












Executing CALL From the Keyboard. The current file can be executed in a local environment by returns a catalog of file information. 











executing from the keyboard. 
~ @ = Statement M Keyboard Execution 
Note: If you execute CALL from the keyboard and O Function O CALC Mode 
1. You concatenate other statements after CALL, and Ol Operator H IF...THEN...ELSE 





2. CALL invokes a subprogram that is subsequently suspended, then resumed, 


then, when the HP-71 returns from that subprogram it does not execute any of the remaining 
concatenated statements. 


Related Keywords 





Input Parameters 


String expression or unquoted string. 
Default: File name without device 
specifier catalogs named file. Device 
specifier without file name catalogs all 
files on that device. Executing "AT 
without specifying either file name or 
device specifier catalogs the current file. 










Restrictions 


A device specifier or a file name 
with optional device specifier. 











file specifier 
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CAT (continued) 


Comments 


The catalog display provides the following file information: 


e Name. 

e Protection, coded as one of the following: F (private), = (secure), — (private and secure), or 
blank (no protection). 

e Type. 


e Length (in bytes). 


e Creation date, time, and port number (if any). The date is displayed in the MM/DD/YY format, 
and the time is displayed in the HH:MM format. 


When you use (AT to list the information on more than one file in a memory device, the files appear 
in the order in which they were created, beginning with the oldest file. The and keys scroll from 
one file to the next. Pressing (9][A] positions the HP-71 to the first (oldest) file in the catalog. Pressing 
(S][¥] positions the HP-71 to the last (newest) file in the catalog. 


Specifying Devices. iT : device id returns information on all files residing on the given device. 


CFT: fATH returns information on all files residing in MAIN memory, while CAT: FPORT¢i? re- 
turns information on all files residing on port #1. 


Cataloging Devices. If one or more memory devices containing files are plugged into your HP-71: 


e Executing CAT ALL returns information on the files in main RAM and in any plug-in memory 
modules and independent RAMS. 


— 





e Executing ©A7T:F0FT returns information only on the files in any plug-in memory modules and 


independent RAMs. 


Pressing [f][V¥] during a CAT ALL or CAT:F ORT operation causes the HP-71 to move from the cur- 
rent memory device catalog to the next plug-in memory module. 


Assigning a Displayed BASIC File to “Current” Status. Pressing the EDI? typing aid 
( ) while in any multiple-file catalog causes the currently displayed file to become the current 
file. An Invalid File Ture condition occurs if the file you select is not of type BASIC. 


Cataloging a Magnetic Card Containing an HP-71 File. Executing CAT CARD displays 
CAT: Align ther ENCILH to prompt you to read a magnetic card into the HP-71.After you pull 
the card through the card reader, the HP-71 displays the file name, track number, and catalog informa- 
tion for the card in the same way as described in the preceding text for other file media. 
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CAT (continued) 


Note: Because of the overhead information needed for card storage, the indicated file size may be 
larger than the actual file size. In BASIC files, this discrepancy will be, at the most, one byte. However, 
for TEXT files—which are always ‘‘padded’’ to a 256-byte boundary—the discrepancy will be in the 
range of 0 to 255 bytes. 


Cataloging a Magnetic Card Containing an HP-75 File. The HP-71 catalogs HP-75 magnetic 
cards in the same way as for HP-71 cards, except that the file type is displayed as for any file that 
is not a “LIF1” type. 


Cataloging Key Assignments. Executing CAT KEES displays catalog information for the 
|: == file, which is the system file of current key assignments. 


Note: If you create a file using keywords from a plug-in module or device, then remove the module or 
device and subsequently execute CAT, one or both of the following may occur: 


e Instead of displaying file type, the HP-71's five-digit internal code for the file type may be dis- 
played. 


e File size may be represented by a value that is 1 to 125 bytes greater than the actual file size. 


Reexecuting the HAT instruction with the subject module or device plugged in eliminates both 
discrepancies. 


Executing LiELA’’ with a line rate of 0.5 and a character rate of infinity (DELAY .3, IHF) 
prevents the catalog header from scrolling. Refer to the DELAY keyword entry. 


Related Keywords 


CAT #. 
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CATS 


47 returns catalog information for the specified file. 


iG ga aa Na IN a ae as ca Sa a eS tt pe Ra i i a i ens a i a 


| Oh Statement M@ Keyboard Execution 
_ M@ Function O CALC Mode 
: (1 Operator @ IF...THEN...ELSE 


fk ee eh an ae aS a ae Ee es ee 


[re anoe 





a 
< 
ros 
ao 
o 
o 
Uv 
o 
o 
~ 
+> 
» 
o 
4 


d 















Examples 
AE=CATECCL, "1: PORTCS 
ci,8] 
Input Parameters 
Item | Hascaibtse - — | _ Restrictions 7 
fie number | Numer expression (ounded oan | None, 


| integer) that corresponds to the file’s | 
| position in the HP-71 or plug-in device. 


| 
device specifier . String expression. : First character must be a colon. 
| Default : MAIN, 


Comments 


For a specified file, CA 7# returns in string form the same catalog information as that returned by 
CAT. For files in main RAM, the length of the string returned is 38 characters; for files on plug-in 
memory devices and independent RAMs, the string length is 43 characters. The last character is a 
blank. The character positions in the string are assigned as follows: 
Port Number | 

fina 

Port 


' Security | File Size Date | Time 


File Name , Code | rie type . In Bytes | Created | Created 


pdb ee 


1-8 10 12-16 18-22 24-31 33-37 39-42 
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CATS (continued) 


If the file type is unrecognized, the five-digit signed integer file type number occupies characters 
11 through 16. 


A positive file number refers to a file’s position on the memory device. For example, GAT#¢22 re- 
turns information on the second file in main RAM. If the specified file number is less than or equal to 
zero, and no second parameter is given, then (7 returns information on the current file. 








Specifying a file number greater than the last file in the specified device returns the null string. The 
null string is also returned if the file number is less than or equal to zero and a second parameter is 
specified. 


If a device specifier string includes a file name, an Invalid Fileseec (error 58) condition 


occurs. 


Related Keywords 


CAT. 
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CEIL 


CELL (ceiling) returns the smallest integer greater than or equal to a specified argument. 





MO Statement M@ Keyboard Execution 
@ Function mM CALC Mode 
O Operator @ iFf...THEN...ELSE 





+O —+frraenene | +) 


Examples 


ALBeCEILeei2 PRIHT "Ceiling = ";CEELEYs 





















Description 


Comments 


CEIL returns a value of type REAL. If the value of the numeric expression is an integer, that value is 
returned. For example: 

eCEILe1.5% returns <. 

e mE TL¢-i? returns -1i. 


e CEIL*-1.5> returns —1i. 


Related Keywords 


FLOOR, FF, THT, IF. 
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CFLAG 


CFLAG (clear flag) clears user and/or system flags specified by keyword or by a flag number list. 









: Mi Statement BW Keyboard Execution 
; (1 Function 1 CALC Mode 
. (1 Operator @ IF...THEN...ELSE 





bi FLAG NUMBER ; 


Examples 


PFLAG ALL CFLAG MATH CFLAG 1,2, 1H# 


Input Parameters 


Numeric expression rounded to an — 32 through 63. 
integer. 


{FLAG ALL clears all user flags. (FLAG MATH clears the math exception flags. CFLAG with a flag 
number list clears the system and user flags specified by the values (rounded to integers) of the numeric 
expressions in the list. System flags numbered less than —32 cannot be cleared by CFLAG. 





Item 


flag number 


Comments 


Related Keywords 


OWZ, FLAG, IHk, IVL, OVF, SFLAG, UF. 
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CHAIN 


HIM purges the current file, copies the specified file into main RAM, and begins executing that 


file. 


® Statement 






M@ Keyboard Execution 
O Function CO CALC Mode . | 
1 Operator @ IF...THEN...ELSE | 
(CHAIN) x 
Examples 
CHAIH TE CARD CHALH PS 
THAIN DEMO: 
aL Parameters 
eA Pay es 7 monn 
: Kem Description nesuiuon® | 
bes ae F : ms Been Se atcecist AP Let te St 
file specifier String expression or unquoted string. File name with optional device 
- _ specifier. | 
} 
Comments 


Chaining allows programs of unlimited size to be run by breaking up such programs into segments. A 
CH { statement in the first segment directs the system to copy and run a second segment. A 
IH statement in the second segment directs the system to copy and run a third segment, and so 
on. When execution of a chained file begins, that file becomes the current file. 





» When (HATH calls the next file, the calling file is purged from memory before execution of the 
chained file. 


HATH releases local environments and clears all program control information associated with a prior 
suspended program. 


Related Keywords 


TORY, FUR. 
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CHARSET 


CHARSET (character set) defines the alternate character set in the ASCII code range of 128 through 
255. 








mM Statement HM Keyboard Execution 

O Function O CALC Mode 

O Operator M@ IF...THEN...ELSE 
Examples 





RSET 
SET 


CHRECLIRCHR ECS 
ROHR ECL ORCHE SLs 









CH 
CHARSET C# 
CHAR SET "% 


Input Parameters 


String expression. 


Comments HP-71 Character Sets 


esos Sar 0 











Restrictions 


charset string 


The character set string is interpreted as a series of six-byte 


: . | Standard 1 
groups. Each successive group defines a successive character 
/ HP-71 
from an alternate character set. The first group defines Gharaater 
character 128; the second group defines character 129, and | Set e 
so on, up to character 255. To add a new character to an ex- 1 97 
isting character set, use the ©HAFSET# function in the 
‘ | Alternate 128 
same way as shown in the second example, above (and de- 
scribed under the next keyword entry). ee 
| Character 
| Set 
255 





__ 
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CHARSET (continued) 


Once an alternate character set is established, you can access any character in the set using CHE: #. For 
example, DISF CHE#¢1223 displays the fifth character in the current alternate character set. If 
you specify less than 128 alternate characters and then use CHF'¥ to select a character number outside 
of the defined range, the HP-71 returns the corresponding character from the standard HP-71 char- 
acter set. Thus, if (1) you have an alternate set consisting of 11 characters (which would be numbered 
from 128 through 138), and (2) you specify the nonexistent 12th character by executing CHR #*133%, 
then the HP-71 returns the 12th character in the standard HP-71 character set. That is, the computer 
returns the same character that would be returned by executing THF #°11:. 


All predefined characters in the HP-71 are six columns wide—although the sixth column is left blank 
to allow for space between characters. Each six-byte group in the character set string corresponds to 
the dots of six consecutive columns in the HP-71 display. The first byte in a group specifies the 
leftmost column in the displayed version of the character. The sixth specifies the rightmost column. 
The lowest-valued bit of each byte corresponds to the topmost dot in a column, and the highest-valued 
bit corresponds to the lowest dot in the column. (Refer to the next illustration.) 


The first of the statements listed under “Examples” on the preceding page defines an alternate char- 
acter set having only one character (which corresponds to character number 128). This character 
resembles the symbol used in integration. 


Byte No. Decimal Value 
of Bit 


123 4 5 6 





1 
2 
4 
Display 8 
Dots 16 
32 
64 
128 
CHR$(64) CHR§$(128) CHR$(126) CHR§(1) CHR§(2) CHR§(0) 


01000000 10000000 01111110 00000001 00000010 00000000 
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CHARSET (continuea) 


If you specify more than 128 characters (768 bytes) in an alternate character set, the HP-71 uses only 
the first 128. If the last group in the string does not contain six bytes, then the remaining bytes of that 
character are assumed to be zero. 


An alternate character set uses three and one-half bytes of user memory, plus six bytes for each charac- 
ter in the set. CHAR SET "" deactivates the alternate set and restores the memory to the user’s avail- 
able space. 


Certain plug-in ROMs may activate alternate character sets without using this statement. In this case 
the character set resides in ROM and requires only seven bytes of user memory (RAM). 


Related Keywords 
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CHARSETS 


CHARSET# (character set) returns a string representing the current alternate character set. 





O Statement M@ Keyboard Execution 

@ Function [1 CALC Mode 

[1 Operator M@ IF...THEN...ELSE 
Examples 

Af = CHARSETS GOISP CHARSETSC1#6,1#6+5] 
Comments 


The length of the returned string is determined by the number of alternate characters currently de- 
fined. Each character you define adds 6 bytes to the string; up to 128 characters can be defined. The 
maximum string length is 6 X 128 bytes. 


CHAFSET# returns the string of bytes specified in the last CHHRSET statement. (Refer to the CHARSET 
keyword entry for the significance of the bytes.) 


Related Keywords 


CHARSET, CHES, 
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CHR$ 


CHE (string conversion) converts a numeric value into an ASCII character. 








o Statement HM Keyboard Execution 
@ Function Oh CALC Mode 
[1 Operator mM iIF...THEN...ELSE 
© © 
Examples 
ASDN, HI] = CHRS¢47 +83 E$ = CHRS{273 


Input Parameters 


Numeric expression rounded to an 0 through 255. (CHR# performs 
integer. modulo 256 on numeric arguments.) 


CHE returns the one-character string having the specified ASCII value. For a table of ASCII characters 
and their equivalent decimal values, refer to pages 322 through 326. 
















argument 





Comments 


Related Keywords 


CHARSET, GISPF, GOISF, HUM. 
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CLAIM PORT 


CLAIM PORT returns an independent RAM module to main RAM status, and is nonprogrammable. 


@ Statement HM Keyboard Execution 


O Function O CALC Mode 
(1 Operator M@ IF...THEN...ELSE 


port 
specifier 









Examples 


CLAIM PORT cfs CLAIM PORT ¢As 


Input Parameters 





port specifier Numeric expression truncated to two 
digits after the decimal point; interpreted as 


p.dd, where: 
p = port number 
dd = device number. 


Comments 


Port 0 contains the internal chain of devices and the HP-IL port. Ports 1 through 4 are the four ports 
in the front of the HP-71. Port 5 is the card reader port. 


Device number refers to the position of a plug-in device in a chain of such devices. In the HP-71, the 
internal RAM (Port 0) device numbers are 0.00, 0.01, 0.02, and 0.03 (where each device number repre- 
sents 4K of RAM). 


Because CLAIM changes the system configuration, all file pointers are reset, the workfile becomes the 
current file, and all FOR, ... HET loops are terminated. 


Related Keywords 


FREE, SHOW. 
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CLASS 





= returns a value indicating the numeric class of the argument. 









OO Statement 
| > Function 
{1 Operator 


M Keyboard Execution 
MM CALC Mode 
@ IF...THEN...ELSE 





argument 0) 





THEM TIHYHEG 


THEN FINITE 





MAL. IHPOTHITE, & 





Input Parameters 







i 
i 
' 
! 
i 
| 
\ 
i 


| argument 
Comments 


between +0 and —0. 
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CLASS (continued) 





:< returns a nonzero integer in the range of —6 through 6, where: 
e The sign of the result agrees with that of the argument. 


e The result separates the machine representable numbers into 12 classes, as follows: 


Class of Argument (x) CLASS(x) | CLASS(— x) 
















Zero (+0 or —0) 1 
Denormalized (MINREAL <= ABS(X) < EPS) 2 —2 
Normalized (EPS <= ABS(X) < +INF) 3 —3 
Infinity (++ INF, or —INF) 4 —4 
Quiet NaN 5 —§ 
Signalling NaN 6 


Related Keywords 


SGM. 
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CLSTAT 


CLSTAT (clear statistical array) clears (sets to zero) all elements in the currently specified statistical 
array. 






B Statement HM Keyboard Execution 
O Function 1 CALC Mode 


O Operator @ IF...THEN...ELSE 
Examples 
CLETAT IF [=i THEN CLSTAT 


Related Keywords 


ADO, CORR, OROGP, LE, NEAH, PREOW, SOEV, STAT, TOTAL. 
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CONT 


CONT (continue execution) continues execution of a suspended program, and is nonprogrammable. 


@ Statement M@ Keyboard Execution 
O Function O CALC Mode 
1 Operator @ iF...THEN...ELSE 





a 


identifier 


Examples 


COT 





EONT 25@ 


Input Parameters 


Line number or label of a program Any valid line number or label 
statement. reference. 


CONT Operation. A running program will be suspended by a FALISE statement, an error con- 


dition, pressing , or single-stepping ( (SST) ). 


Executing (CHT without specifying a line number or label reference (or pressing [CONT] ) 
resumes execution at the suspend statement. Specifying a line number or label reference with CONT 
resumes program execution at that line number or statement. If the HP-71 does not find the specified 
line number, but does find a higher-numbered line, execution is continued from this line number. 











Comments 


If an error occurs during program execution, executing [iT continues the program with the state- 
ment causing the error. This feature enables you to debug a program that has been halted by an error, 
then resume execution. For example, errors related to variables can be corrected and the program 
continued from the statement in error. 
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CONT (continued) 


Note: Editing a program clears the suspended state of a program. Thus, attempting to continue a 
program after editing that program causes execution to begin at the start of the program. 


Continuing a program that is not suspended is equivalent to running the program. 


Suspended Programs. When a program is suspended for any reason, the SUSP annunciator is dis- 
played. While a program is suspended, memory is allocated to the suspended program for local 
variables, subprograms, and other program control information. Modifying a program or executing 
EMO, ENO ALL, or STOF clears the SUSP annunciator and releases the memory used for program 
control. © clears the SUSP annunciator, but does not release memory. 





Related Keywords 


EHC, PAUSE, STOP. See also the descriptions of the (ATIN], [SST], and keys in your HP-71 Own- 
er’s Manual. 
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CONTRAST 





adjusts the display contrast (viewing angle). 


@ Statement @ Keyboard Execution 
O Function OO CALC Mode 
O Operator @ IF...THEN...ELSE 





Examples 





Input Parameters 


ee 
contrast value Numeric expression rounded to an 0 through 15. 
integer. 


Comments 
COHTEAST controls the parameter specifying the angle at which the display is most easily viewed. 








The contrast value may be varied between 0 and 15, where 0 is the shallowest angle and 15 is the 
steepest. This corresponds to the lowest and highest contrast, respectively. 


The default display contrast value is 9. 
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COPY 


‘ creates a new (destination) file and copies information from an existing (source) file to the new 





file. 









M@ Statement M Keyboard Execution 
O_ Function 1 CALC Mode 
O Operator M@ IF...THEN...ELSE 


oil LG Ge el 
a) = 












Examples 
copy TO DEMOL cory 
FILEi TO FILEZ COPY 





Input Parameters 


String expression or unquoted string. 
Defaults: Refer to comments, below. 


i ig a 









Any valid file specifier. 





file specifier 





Comments 


The source and destination files for a CCF‘ operation can exist in main RAM, in an independent 
RAM, on a magnetic card, or on an external file storage device (except that when copying a file from a 
card, the destination file must be in main RAM). When copying into main RAM or to independent 
RAM, the destination file is a new file. The source file is never altered. 
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COPY (continued) 


Defaults. 
¢ When the current file is the source file, it is unnecessary to specify a source file name. 


e It is unnecessary to specify either the source or destination file names when the following three con- 
ditions apply: 


1. The current file is the source file. 


2. The current file is in a device that is plugged into a port. 


3. You want the destination file to be created in main RAM with the same name as the source 
file. 


Note: The destination file specifier can be omitted only when the source file is in an external 
device or on a magnetic card. (The HP-71 treats a device plugged into a port as an external 
device.) If the source file is a special system file (such as work file or keys), the HP-71 
converts the destination file name to uppercase. 


e¢ When the destination device is not specified, it is assumed to be main RAM. 


If a file having the same name as the destination file already exists in the destination device, a File 
Exists (error 59) condition results when “(iF attempts to create the new (destination) file. 


Card Reader Operation. You can use the reserved word (FFI! or the device specifiers : CHEE or 
:F CRO to reference the card reader. The :F Ff specifier following the destination file name cre- 
ates a “private” card file. 


When copying a file to a card, the source file specifier must refer to a file that is currently in either 
the HP-71 or a memory device plugged into the computer. If the source file specifier is omitted, the 
current file is copied to the card. If the destination file specifier is omitted, the source file name is 


used as the destination file name on the card. For example, COF’ AFILE TO CARO creates a 
creates a card file named EFILE 





card file named AFILE. COFY AFILE To BFILE: <A 
from the source file (named AF ILE). 





If the source file is a special system file (such as work file or keys), and the destination file- 
name is omitted, (asin COFY KEYS TO CAF), the HP-71 converts the destination file name to 
uppercase. 






n 


When copying a file to a card, each side of each card must be passed through the card reader twice. The 
second pass verifies that the data was recorded correctly. If the data was not recorded correctly, the HP-71 
prompts you to rewrite the card. 


& 
When copying a card to memory, if the destination file name is omitted, the file name on the card 
becomes the destination file name. 
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COPY (continued) 


ti. It has no effect on the 





Specifying :F CEO as the source device is equivalent to specifying 
privacy of the destination file. 


aan to copy a card that was written on the HP-75 and contains a non-LIF1 file type causes an 

OL fsr cd (error 69) condition. This condition can also be caused by an HP-71 file of an 
inion ane. re unknown HP-71 file type results if the computer requires a certain LEX file or 
plug-in module to recognize the file type, and that LEX file or module is not present.) 










= to store the current key assignments in a file. When 
(which is the current system key assignment file): 


Key Assignments. You can use (fF 
copying from a key assignment file to k 





e If key does not already exist, simply execute CLF file specifier T2 KEYS. 





C 


== already exists, either purge it (by executing FURGE KEYS) or rename it (by executing 
KEYS Tt file specifier), then execute COF' file specifer TG KEYS. (Attempting to 
copy a key assignment file to k == when keys already exists results ina File Exists — 
error 59 — condition.) 








Related Keywords 


PRIVATE. 
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CORR 


mOQEEF (correlation) returns the sample correlation between a pair of variables in the current statisti- 
cal array. 


O Statement M@ Keyboard Execution 


@ Function HM CALC Mode 
Ol Operator @ IF...THEN...ELSE 





variable variable 
number number 


Examples 


variable number Numeric expression rounded to an Must be a value in the range of 1 
integer. through the current STAT array 
dimension. 








Comments 


ORE returns a REAL value. 


Related Keywords 


ROO, CLSTAT, OROPF, LE, MEA, PREDY, SOEV, STAT, TOTAL. 
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COS 


1 (cosine) returns the cosine of its argument. 







' o Statement HM Keyboard Execution 
@ Function mM CALC Mode 
[| Operator @ IF...THEN...ELSE 


Examples 





Input Parameters 









argument 


Comments 





CES assumes that the argument is expressed in the current angular setting. The HP-71 first reduces 
the argument by 360° (or 27 if in radians setting). If in radians setting, this reduction takes place with 
a 3l-digit representation of 7 for increased accuracy. Also: 


- COS(90 + n * 180) = [(—1)”] * 0; n = 0,1,2,3, ... (Degrees setting). 
s COS(—x) = COS(x). 


Related Keywords 


AHGLE, ACOS, ACS, ASIH, ASH, ATAH, ATH, OEG, DEGREES, OPTION, RAO, RADIANS, OTH, 
TAH. 
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CREATE 


CREATE creates a data file in main RAM or in an independent RAM. 


@ Statement M Keyboard Execution 


OO Function O CALC Mode 
O Operator @ iF...THEN...ELSE 


fil 
CREATE 












record 
length 


Examples 


CREATE TEST MENOS45 













TEXT, LIF1, DATA, or SDATA file 
type. 

File name with optional device 
specifier. 

DATA and SDATA files: 1 through 
65,535; TEXT files: 1 through 
1,048,575. 


Unquoted string indicating the type of file 
to create. 


file type 






















file specifier String expression or unquoted string. 


file size } 
record length 












Numeric expression rounded to an 
integer. 
Default: Refer to ‘‘Comments.”’ 







Comments 


The file type tells the HP-71 which format to use when writing information into the file. 


Executing CREATE does not open the created file. To open a newly created data file for writing, use 
the ASS1GH# statement. 
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CREATE (continued) 


A file placed in memory as a result of executing CFEATE will increase in size if you use FE IHT# to 
sequentially write to a new record immediately following the current last record of the file. 


TEXT (LIF1) Files. A TEXT file contains variable length records of ASCII character data. The 
name “LIF1,” by which this file type is referenced in the HP-75, can be used in place of the name 
“TEXT.” However, the HP-71 still regards as a TEXT file any file carrying a “LIF1” designation. This 
file type is the same as that of the HP Logical Interchange Format (LIF) file type “1” which serves as 
an interchange file format among most Hewlett-Packard computers. The file size is specified in bytes. 
Both the minimum file length and the default file size are zero. Because a LIF1 file contains records of 
varying length, you cannot specify the file’s record length. 


DATA files. A DATA file type has fixed length records which can contain both numeric and string 
values. The file size is specified in number of records, with a default size of zero. The record length is 
specified in number of bytes. If not specified, or specified as 0, the record length defaults to 256 bytes. 


SDATA files. The SDATA file type is the same file format as the DA (data) file produced by the 
HP-41 calculator. Thus, SDATA files are register-oriented. Each record is 8 bytes in length. The HP-71 
can write only numeric values to this type of file. Notice, however, that the HP-41 can store both 
numeric and alpha data in this file, which can be read by the HP-71 FEAL# statement. (Refer to 
READ# and PRINT# for further information.) The file size is specified by the number of records in the 
file, with a default size of zero. 


Related Keywords 





H#, FRIHT#, FER 


7 
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DATA 





ATA statements contain data that can be read by 





M Statement O Keyboard Execution 
O Function O CALC Mode 
C1 Operator 0 IF...THEN... ELSE 








eae 
re 


string 






Examples 
DATA 123,456, "Hello" 
DATA FISE,F GH Gin? 


DATA "This is = string" & "“ expression" 


Input Parameters 








Item Description Restrictions 
expression Refer to glossary. None. 
unquoted string Refer to ‘‘Punctuation and Space in Data None. 


Items,’’ on the next page. 





Comments 


CIT statements provide the means for ordering string and/or numeric data items for assignment to 
corresponding variables listed in FEAL statements. Each time a running program encounters a vari- 
able ina FEC statement, it assigns to that variable the next consecutive data item from a DATA 
statement. If a FED statement variable is encountered after all of the data items in a [437A state- 
ment have been assigned, the first data item in the next consecutively-numbered CATA statement is 
assigned to that variable. A program or subprogram can contain any number of [:# 7H statements at 
any locations. 
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DATA (continued) 


Data Statements in Subprograms. When a subprogram is called, the HP-71 remembers the loca- 
tion of the next item to be read in the calling program in anticipation of returning from the 
subprogram. Within the subprogram, the first item read is the first item in the lowest numbered 
Ci 1 statement within the subprogram. When program execution returns to the calling program, the 
operations resume where they were suspended when the subprogram was called. 






Constants and Variables. A numeric or string constant must be read into a variable that can store 
the constant. In the HP-71 a numeric constant (or expression) ina [TF statement can be read into 
either a numeric variable or a string variable. However, a string constant can be read only into a string 
variable. That is: 





» Numeric values in a [}iT# statement can correspond to either numeric or string variables in a 
EAC statement used to access that [iFiTA statement. A numeric value read into a string vari- 
able is interpreted as an unquoted string. 






. String values in a DATA statement can correspond only to string variables ina FEAL! statement 
used to access that (74 statement. Attempting to read a string value into a numeric variable 
causes an immediate error condition. 


If a string can be interpreted as a valid string expression (such as DATA CHE) followed by a 
comma or the end of the line, then it will be evaluated as such when read. Otherwise, the computer 
treats it as an unquoted string. 
Punctuation and Spaces in Data Items. A data item can be any one of the following: 

- Numeric expression. 

- String expression. 

- Unquoted string. 


To place an unmatched quote mark in a string expression, you must enclose the mark within a pair of 
the opposite type quote marks. For example: 






DATA “Class of ‘S?", 42 


Also, the computer ignores any leading or trailing blanks in an unquoted string expression. Thus, to 
include such blanks in a string expression, they must be within quotes (that is, in a quoted string). 


Since [ATA statements can contain {| and & symbols, (IAT cannot be followed by a comment or 
another statement. 
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DATA (continued) 


Related Keywords 
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DATE 


= returns the current clock date. 


















O Statement W Keyboard Execution 
B® Function M CALC Mode 
Ol Operator M@ IF...THEN...ELSE 





Examples 


Comments 


[ATE returns the current clock date as an integer in a year/day (YYDDD) format, where YY is the 
year and DDD is the day number of the year. 


Related Keywords 


DATES, SETOATE. 
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DATE$ DEF FN 





CITE (date string) returns the current calendar date as an eight-character string in a year/month/ 
day (YY/MM/DD) format. 


EH (define function) indicates the beginning of a user-defined function definition. 

































™@ Statement 1 Keyboard Execution 
O Statement HM Keyboard Execution Function O CALC Mode 
@ Function QO CALC Mode 1 Operator O IF... THEN...ELSE 
[1] Operator @ IF...THEN...ELSE om 
5 
eae -o-os 
ear Oa 
Examples 






- poe max imum - Wie 


neetne toruee length 


i 
bed 
wy 
Th 
mc 









= 
Laer) 


a 7 string 
expression 





Examples 
COEF FHROR, ¥, 23S CHR 3444902 DEF FAL#CifsdeT#, Re, 8) 
DEF FHACT,J,K,B#> DEF FO 


Input Parameters 


Letter, or letter followed by a digit. 





numeric variable None. 


















formal parameter Numeric or string variable name. None. 





numeric expression | Refer to the Glossary. None. 





string variable Letter followed by # or letter and digit None. 


followed by #. 








| 
maximum string 
length 





Numeric constant. 0 to 65535. 


Default: 32. 
Refer to the Glossary. 






String expression None. 
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DEF FN (continued) 


Comments 


A user-defined function computes a single value, and is used by specifying the function’s name and 
actual parameter list in an expression; for example: 7#F HF © +1. (Refer to the FN keyword entry on 
page 116.) A function definition can appear anywhere in a main program or subprogram, and can be 
composed of either a single statement or multiple statements. A [IEF FH statement with no = symbol 
is the beginning of a multiple-statement function definition that must have a corresponding 
EHO OEF statement. 


A user-defined function can have from 0 to 14 parameters. The formal parameters must match the 
actual parameters in both number and type. All parameters passed to a function are passed by value. 
Parameters appearing in the function definition list are local to the function and are inaccessable 
from the main program. However, all global variables having names that differ from the function’s 
formal parameters can be accessed from within the function. 


A string function returns a string value. The string length of a formal string parameter is automati- 
cally increased, if necessary, to match the length of the actual string value passed at execution. How- 
ever, if the length of the formal string parameter becomes greater than the length of the actual string, 
an error results. For example, in the following program segment, the actual string value (A) is three 
characters, but the corresponding formal string parameter (T#) contains five characters. Thus, line 
110 would cause an error because the formal string length cannot be increased beyond that specified 
by the actual string length. 


10 A$="ABC’ 
20 DISP FNL§(A$) 


100 DEF FNL§(T$) 
110 T$="12345" 
120 END DEF 


A function can call itself (which is termed recursion). 


For a user-defined string function to return a string containing more than 32 characters, you must 
specify the maximum string length parameter. Otherwise, whenever the function value exceeds 32 
characters,a String #1 (error 37) condition occurs. (The way that DEF FH uses the maximum 
string length parameter for a user-defined string function is similar to the way that [1IM uses the 
maximum string length parameter for a string variable.) 


Related Keywords 
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DEF KEY 


ClEF KE (define key) assigns a character string to the specified key. 








@ Statement M@ Keyboard Execution 
: 1 Function 1 CALC Mode 
: (1 Operator M@ IF...THEN...ELSE 


pgp, pbeenent | fae ad 
string 


assignment type 








Examples 
ce Ee DEF KEY "Fe", "CALL PMT" 
EF KEY E#,"RUM 2a@ DEF KEY "A" 
KEY "#64". RUM "SUBLS! 


Input Parameters 


String expression indicating key to be 
defined. (Refer to glossary.) 













\ Item 


Less than five characters. 





key name 








assigned string String expression. None. 






| key assignment None. 


| type 


or : symbol, or blank. (Refer to 
‘Assigning Keys,’’ on the next page.) 


Comments 


Key assignments are useful for repetitive character string entry, data entry, partial command entry, 
direct execution, and generally customizing the keyboard to your needs. 
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DEF KEY (continued) 


Assigning Keys. The following table describes the three types of key assignments: 





Punctuation Used 
To Define Key 
Assignment Type 


Assignment 
Type 


Result of Pressing 
the Assigned Key 
Typing Aid 


Semicolon (; ). Displays the assigned string as though you 


manually typed it in. 


Direct Execution Colon (:). The assigned string is executed without 


altering the display. 


Immediate Execution j| None (default). 


The HP-71 displays the assigned string, then 
performs the same as if you typed in the 
assigned string and pressed . 








Key assignments are only active when the user keyboard is active. If the first character of a multiple- 
character key name string is #, the string is interpreted as a key number. If the first character of a 
two-character string is upper- or lowercase “F” or “G,” the string is interpreted as the [f]- or (9} shift 
of the key specified by the second character. Any excess or unnecessary characters in the key name 


string cause an error condition. 
Primary Key | 1 through 56 
Functions (fa), (Ww), (E).... &)) 


The numbers to use when entering a [IEF EEY 
ment are shown in the table to the right. 


assign- 






Note: The {f]- and [9] shift keys cannot be redefined. 





(f]- Shift 57 through 112 
Functions | ( LIF], ... (CONT]) 



















113 through 168 
(fa), w)--- 2) 


(9)- Shift 


Functions 





The HP-71 stores any current key assignments in a special system file named & e142. Each time you 
execute [IEF KE’, the computer updates the keys file. 


Deassigning Keys. [iEF KE‘ also deassigns keys by returning them to their default assignments. 
To deassign a key, enter [/EF KEY and the key name only, then press [END LINE]. 





Related Keywords 
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DEF KEY (continued) 
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DEFAULT EXTEND/ON/OFF 





rE EAULT sets the math exception traps to specific values. 
mM Statement @ Keyboard Execution 
O_ Function O CALC Mode 
(1 Operator @ iF... THEN...ELSE 












Examples 

DEFAULT OFF DEFAULT EXTEND 

DEFAULT OH IF A¢& THEN DEFAULT EXTEND 
Comments 


The trap actions may be set individually for each of the five exception flags by using the TRAF func- 
tion described on page 293. However, there are some groups of actions that are common and can easily 
be set by the DEFALILT statements: 


DEFAULT OFF : Sets the traps for the UNF, OVF, DVZ, and IVL flags to zero. Sets the trap 
for the INX flag to 1. For the INX flag (flag —4) a trap value of 1 or 2 
produces the same results. Refer to the description of the TRAF function 


in your HP-71 Owner’s Handbook. 
OH : Sets the traps for the INX, UNF, OVF, DVZ, and IVL flag to 1. 


EXTENG: Sets the traps for the INX, UNF, OVF, and DVZ errors to 2. Sets the trap 
for the IVL flag to 1. 








Related Keywords 


TRAP. 
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DEG 


[IEG (radians to degrees conversion) converts arguments expressed in radians to degrees. 









O Statement M@ Keyboard Execution 
@ Function 1 CALC Mode 
C1 Operator @ IF...THEN...ELSE 


Examples 








Comments 


The conversion constant used by [EG is accurate to 15 digits, which often produces more accurate 
results than a conversion which does not use this function. 


Related Keywords 


DEGREES, FAQ, RA 
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DEGREES 


CEGEEES sets the unit of measure for expressing angles to degrees. It is a short form of the 
OF TIOGOW AWHGLE OEGREES statement. 








Mm Statement M Keyboard Execution 

Function Ol CALC Mode 

1 Operator @ sIF...THEN...ELSE 
Examples 

iz 1 E Be ir Ai T 





Comments 





After you execute | #EES, executing any function that returns an angle will return the angle in 
degrees units. Operations using parameters to represent angles interpret the angles in degrees. 


The Degrees setting is the HP-71 default angular setting. Both the Degrees setting and its coun- 
terpart, the Radians setting, are global. 





Executing 0 & clears both the RAD annunciator and system flag — 10. 


Related Keywords 





OETIOM, FADE 
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DELAY 


“'¥ sets the rate at which lines and characters within a line will scroll in the display. 









M@ Statement M Keyboard Execution 
O Function O CALC Mode 
O Operator @ IF...THEN...ELSE 


rate 





Examples 


i 





®, THE 


Input Parameters 


Numeric expression rounded to the 
nearest 1/32 second. Values greater than 
or equal to 8 are considered infinite. 






Restrictions 


Zero to infinity. 














line rate 









character rate Numeric expression rounded to the nearest | Zero to infinity. 
1/32 second. Values greater than or equal 
to 8 are considered infinite. 


Default: 0.125 second. 


Comments 


The character rate is the number of seconds to delay between characters in the display. A zero char- 
acter rate causes the display to be immediately advanced to show the last part of the line. An infinite 
character rate causes the first part of the line to remain in the display indefinitely. 


The line rate is the number of seconds to hold each display line (after character movement halts) 
before displaying the next line. An infinite line rate causes the line to remain in the display until you 
press a key. A line rate of zero implies that lines are not held in the display at all. 


The HP-71 interprets as infinite any line and character rates that equal or exceed eight seconds. Rates 
of less than 0 are interpreted as 0. 
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DEL AY (continued) 


Related Keywords 
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DELETE 


ETE deletes one or more program lines from the current file, and is nonprogrammable. 











@ Statement M@ Keyboard Execution 
O Function O CALC Mode 
Ol Operator @ IF...THEN...ELSE 







DELETE 





ALL 
eat 


line number 


[es s final 5 
line number 


Examples 





Input Parameters 


1 through 9999. 








start line number Integer constant identifying a program 


line. 


















final line number Integer constant identifying a program 
line. 


Default: Start line number. 


Start line number through 9999. 


Comments 


To delete a single line, specify only that line number. (You can also delete a single line without using 
the [iELETE statement by entering the line number and pressing ). To delete a block of 
program lines, specify the start and final line numbers in the DELETE statement. 


TE 





ETE LL deletes all lines in the current file. (The file header remains.) 
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DESTROY 





: deletes variables and arrays from memory. 








BH Statement ™ Keyboard Execution 
O_ Function 1 CALC Mode 
1 Operator M@ IF...THEN...ELSE 









DESTROY 


ceca) 


Examples 


DESTROY ALL 





DE 


Input Parameters 


| tem Description Restrictions 


Comments 









Destroys variables and arrays, reclaiming the memory they consumed. Memory-reclaiming deletion of 
a specified array or variable occurs when (IESTEGY is executed. If the computer is executing a 
subprogram or user-defined function, only the variables created by that entity are deleted. DE~ 
= TECy FLL deletes all variables in the current entity (program, subprogram, or user-defined func- 
tion). Executing DESTROY ALL within a user-defined function causes program execution to 
immediately exit from that function in the same way that it does when executing ENG DEF. 


Related Keywords 
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DIM 





| (dimension) allocates memory for string or REAL variables and arrays. 






M@ Statement M Keyboard Execution 
1 Function MO CALC Mode 
. (1 Operator M@ IF...THEN...ELSE 









dimension 
limit 2 


string length 


Examples 






Input Parameters 


Letter followed by optional digit. 


Letter followed by #. or letter and digit 
followed by #. 







numeric variable None 















string variable 





None. 












dimension limit 1 } 


‘ Soh Numeric expressi i 
dimension limit 2 pression rounded to an integer. 


Option Base setting to 65535. 





maximum string 


Numeric expression rounded to an integer. 
length 


Default: 32. 





1 to 65535. 
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DIM (continued) 


Comments 


CIM creates REAL variables and arrays, and string variables and arrays. Creation occurs upon execu- 
tion of (IF. The dimension limits are evaluated at creation time. The lowest-numbered subscript in 
any dimension is 0 or 1, depending on the OFTION BASE setting when the array is created. 
CE TION BASE has no effect on maximum string length or on substring indices; the first character 
always occurs at position 1. Numeric elements are initialized to zero and string elements are initialized 
to null (no characters). 


If (IM specifies a simple numeric variable that already exists, the variable is reinitialized to zero. Other 
variables are redimensioned, but not reinitialized (unless the data type—or, if a string variable, the 
maximum string length—is changed). If 01" expands an array, it also initializes all newly-created 
elements in the array. Notice that redimensioning does not necessarily preserve an element’s position 
within an array, but does preserve the sequence of elements within an array. (Refer to “Declaring Ar- 
rays (DIM, REAL, SHORT, INTEGER)” in section 3 of your HP-71 Owner’s Manual.) 


The following tables indicate the conditions that apply to REAL numeric variables and arrays, and to 
string variables. 







REAL Numeric Variables 











Initial Value 0 

Numeric Precision 12 Decimal Digits 
Exponent Range +499 

Maximum No. of Array Dimensions 2 

Maximum Dimension Limit 65535 


Memory Usage in Bytes 
e Simple Variable 9.5 
e Array 8*(Dim1 - Base + 1)*(Dim2 - Base + 1) + 9.5 












Initial Value 

Default Maximum Length 

Possible Maximum Length 
Maximum No. of Array Dimensions 


Maximum Dimension Limit 
Memory Usage in Bytes 

¢ Simple Variable Memory Usage 
e Array 


Related Keywords 


THTEGER, OFT 
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DIM (continued) 


String Variables 


Null 

32 Characters 
65535 Characters 
1 

65535 


Maximum Length + 11.5 
(dim — base + 1) * (Maximum Length + 2) + 9.5 





SHORT. 
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DISP 


[11 (display) displays numeric and string data. 


@ Statement M@ Keyboard Execution 


[] Function O CALC Mode 
Operator @ oIF...THEN...ELSE 


Osi} +O 








Examples 





Input Parameters 


Numeric or string expression. 










Restrictions 













expression None. 








column Numeric expression rounded to an integer. | Greater than zero. 


Comments 





You can omit the statement name itself in all cases except immediately after T i or 


The numeric format depends on the currently selected display format. (Refer to the STR$ keyword 
entry for details on various formats.) A leading blank is added before positive numbers and a trailing 
blank is appended to the end of all numbers. These blanks are associated with the displayed number 
itself, and not with the punctuation on either side of it. No blanks are added to either side of string 
items. 
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DISP (continued) 





After f5F is executed, the display remains unchanged until explicitly changed by another state- 
ment, keyboard entry, or program error. 


Punctuating DISP Statements. Items to be displayed must be separated by semicolons or com- 
mas, which themselves affect the display format. When the HP-71 encounters a semicolon after an 
item, it displays the next item immediately adjacent to the first item (although numbers always have 
one or two blanks associated with them, as described above). However, if the remaining line width is 
not sufficient for the entire item, it will be displayed on the next line. 


Commas between items cause the HP-71 to format the items in display “zones.” A display zone is 21 
characters wide. (The last zone in a display is less than 21 characters if it exceeds the remaining 
display width.) The normal display width of 96 characters includes five zones: four 21-character zones 
and one 12-character zone. When the HP-71 encounters a comma between items in the display list, it 
skips to the beginning of the next zone (or to the next line if the remaining line width is not sufficient 
for the entire item). To cause a blank zone of 21 characters, enter two adjacent commas in the display 
list. 


The effect of commas and semicolons can be used to added advantage when these symbols are the last 
ones in the display list. For example, ending the list with a semicolon causes subsequent characters to 
be displayed adjacent to the last output. Ending the list with a comma causes subsequent characters 
to be displayed on the same line, but in the next display zone. Ending the list with neither causes 
subsequent characters to be displayed on the next line by sending a carriage return/line feed to termi- 
nate the line. 


The [: 





display list is equivalent to the ANSI minimal BASIC print list. 








Use of TAB. TFE positions £ (and F ¥T) output at the column you specify. If the current 
column position is beyond the specified the computer first moves to the next line, then posi- 
tions itself to the specified column. If the column position value exceeds the current line width, - 
computer reduces the position value by a multiple of the line width (in a manner similar to the FES 
function), then moves to the reduced column position. 








Related Keywords 





iSTHG, EMG, Fis, 
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DISP USING 


OISE USING (display using) displays the display list items in a user-specified image format. 





@ Statement 
OO Function 
OO Operator 


@ Keyboard Execution 
[11 CALC Mode 
B IF...THEN...ELSE 








input Parameters 











Description 


1 through 9999. 








Integer constant identifying a program 
line. 


line number 









format string String expression. Refer to the IMAGE keyword entry. 











None. 





numeric or string expression. 





expression 
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DISP USING (continued) 


Comments 


Ci13F may be omitted in all cases except after THEN or ELSE. The display items in the display list 
must be separated by commas or semicolons. Notice that, contrary to the use of commas and 
semicolons with the [11 SF statement, such punctuation has no effect on the spacing between displayed 
or printed items. 











C LIS THG requires a format string to format the output items. If there are no display items, 


there may or may not be any output to the display, depending on the items entered in the format 
string. 





If (PSF Hi references a line number, 1/GE must be the first statement in that line. When 


executed from the keyboard, the computer searches for an IMFIGE statement at the referenced line 
number in the current file. 





If DISF LUSIHG contains a string expression for the image, that expression must evaluate to a valid 
format string, as described in the IMAGE keyword entry. 


Example. 


Program segment: 


10 S$= '2X,”"’ & ‘‘Today’s” & ’’’,10A,‘‘$’’2D.DD' 
20 DISP USING S$; “ Special’’,2.95 


Program output: 


Today’s Special $2.95 


Related Keywords 





FRINT US 











rl 
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DISP$ 


CIS (display string) returns a string containing all readable characters in the display. 





1 Statement M@ Keyboard Execution 
@ Function Ol CALC Mode 
O Operator @ oIF...THEN...ELSE 
Examples 
Ae=( IF OO " THEH ide ELSE 





Comments 


DISF# returns a string of up to 96 characters containing all 0 1 SF # readable characters in the 
display. 


A readable character is any character displayed while the cursor is on (as it is during keyboard entry). 
The string CHR #¢27>%"<" turns off the cursor, whereas CHR#¢ 272%" > " turns it on. Therefore, 
for example, the program 


18 O1SF CHRF¢e "SHonm"&CHRE CEP 28" <-readabl"SCHREC SP IR"> 


2H OF=01TSF# 





assigns the string “None” to D$. The first cursor-on sequence makes readable the characters “Non”; 
the cursor-off sequence makes “-readable” non-readable; and the second cursor-on sequence makes “e” 
readable. 


DISP+ allows a number ('AL<D1SF#3) or string keyed into the display to be used directly by a user- 
defined key or a subsequently-run program. If there are no readable characters in the display, the null 
string is returned. In general, characters displayed by a DIP statement are not readable. 
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DIV 


il! (integer quotient division) returns the integer portion of the quotient of the dividend and the 
divisor. That is: 


xOivy = TPexeys. 







O Statement M Keyboard Execution 
Ol Function M@ CALC Mode 
@ Operator @ IF...THEN...ELSE 


Examples 





Input Parameters 


- dividend 
divisor 


Numeric expression. 
Comments 










Restrictions 









Subject to operator precedence. 
Division by zero and division of Inf 
by Inf are not allowed. 






The backslash character (ASCII 92) is an alternative form of the & 





| operator. 


Related Keywords 

















~ (division operator), F 











ee ee 
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DROP 


[EGE removes the coordinates of a data point from the data set represented by the summary statis- 
tics in the current statistical array. 





M@ Statement M Keyboard Execution 
O Function [1 CALC Mode 
(1 Operator @ IF...THEN...ELSE 








_— 


coordinate 





Numeric expression giving coordinate 
(variable value) of data point. 








missing coordinates are assumed to equal zero. 


Related Keywords 





AOD, CLSTE 
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DTH$ 


CITH (decimal-to-hexadecimal string) converts a decimal number to a five-digit string representing its 
hexadecimal value, with leading zeroes included. 







O Statement ™@ = Keyboard Execution 
@ Function O CALC Mode 
Ol Operator M@ iF...THEN...ELSE 


Oram} +) 





input Parameters 


Numeric expression rounded to an 0 through 1,048,575. 
integer. 


A typical usage is converting a decimal number to a hexadecimal address in conjunction with the 
Fy 5, HTC, and FEE functions, and the FOKE statement. 












: argument 





Comments 


Related Keywords 


A 





HTO, FEEES, | 
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DVZ 


C2 (divide-by-zero) returns the divide-by-zero flag number (—7). 








O Statement M@ Keyboard Execution 
@ Function ™@ CALC Mode 
O Operator @ IF...THEN...ELSE 
DVZ 
Examples 
I Fy Duco TH 





Related Keywords 





Rite TEE 
Pig dk wiley 
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EDIT 


’ enables you to enter a new BASIC program or to edit a BASIC program already in memory, 
and is nonprogrammable. 










@ Statement W Keyboard Execution 
Ol Function O CALC Mode 
0 Operator @ IF...THEN...ELSE 





specifier 





omy 


Examples 





Input Parameters 


String expression or unquoted string. File name with optional device 
Default: System workfile. specifier. 


The BASIC file you specify with Ef&17 becomes the current file. If the file does not exist, ELIT 
creates it. If you do not specify a file, the work: fii becomes the current file. When you execute 
EQIT, the HP-71 displays the specified file’s catalog information. 







: file specifier 


Comments 





You can perform LIT, EUH, MERGE, COP’, RENAME, and other file operations on the current 
file without specifying its file name. Also, the file’s program lines may be viewed and edited using the 
scroll keys. 











EDT file name: IH initiates a search in main RAM only for the specified file. If the file is not 
found, it is created in main RAM. 
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EDIT (continued) 


ELIT filename: FURT<n2 initiates a search of port n only for the specified file. If the file is not found 
and if the device plugged into that port is an independent RAM, the file is created in that device. 





EQ IT filename: FUT (no particular port cee!) initiates a search of all plug-in memory devices 
for the specified file. If the file is not found, Efi7 creates the file on the first independent RAM 
having enough room. 


If you do not specify any device, and Efi7 does not find the file, the HP-71 creates the file in main 
RAM. As is always the case when no device is specified, the HP-71 searches main RAM first, then 
searches any plug-in memory devices. 


EIT clears any program control information. This includes collapsing all (internally-maintained) 
execution stacks and releasing any local environments. (In this regard, E{:} IT performs the equivalent 
of EHO ALL.) Consequently, executing Ef:17 while a program is suspended (SUSP annunciator 
displayed) removes the program from the suspended state and clears the SUSP ee Also, 


because Efi iT clears the aforementioned stacks, it cannot be used ina FOF . loop. 


Related Keywords 


(SACs 
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END 


EHC terminates a subprogram, user-defined function, or program. 










HM Statement @ = Keyboard Execution 
1 Function 1 CALC Mode 
C1 Operator @ IF...THEN...ELSE 


aie 
ALL 


Examples 


EHD ALL 





Comments 


END in a Program. EH is the last statement executed in a program. (Program execution can also 
be terminated with 3TiIF'.) When a program has been suspended (refer to the PAUSE keyword entry), 
you can clear the suspended state by executing EHD from the keyboard. 


END in a Subprogram. Executing EHD in a subprogram is equivalent to executing EHD SUE. Re- 
fer to “END SUB Comments” on the next page. 


END in a User-Defined Function. Executing EHD in a user-defined function is equivalent to ex- 
ecuting EHC) QEF. Refer to “END DEF Comments” on the next page. 





The END ALL Statement. £ Fil. releases all levels of local variables and memory associated 
with a program, any subprogram(s) it called, and any user-defined functions in either the program or 
the subprogram(s) it calls. 


Related Keywords 


EHO DEF, EHD SUB 
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END DEF/SUB 


E REF (end function definition) causes a normal return from a multiple line user-defined func- 
tion call. 





EHC! SUB (end subprogram) causes anormal return from a subprogram invoked by a CALL statement. 


Statement —™ Keyboard Execution 


Function Ol CALC Mode 
Operator O IF...THEN...ELSE 





END DEF 


END SUB 


Examples 


EMO DEF EME SUB 


Comments 


END DEF Comments. EHl[ [IEF indicates the end of a user-defined function, and must be the last 
statement in a multiple statement user-defined function definition. EHD DEF terminates function 
execution and returns control to the expression containing the FH call. The value of the function is set 
by the most recent execution of FI variable name = expression. 


When a user-defined function is invoked, it not only uses memory to create its local variables, but it 
also requires memory to retain information about the global environment. If program execution halts 
during execution of a user-defined function, the local variables and memory used by that ee 
are not automatically released. However, you can release this memory by executing EH from 
the keyboard. This terminates the user-defined function and also affects control of Secutanti in one of 
the following two ways: 








e If the user-defined function was invoked by a program, then suspended, executing ENE i 
from the keyboard suspends program execution at the statement following the statement that 
called the function. 


e If the user-defined function was invoked from the keyboard, then suspended, executing EHD 
CES from the keyboard returns control to the keyboard and does not continue the statement that 
invoked the function. 





When used in a user-defined function, Ef and GEST FiLL operate in the same way as EH 


TERS 
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END DEF/SUB (continued) 





END SUB Comments. Encountering during subprogram execution terminates the sub- 
program, releases the local variables and memory associated with the terminated subprogram, and 
returns program execution to the statement following the _. that invoked the subprogram. If the 
subprogram was invoked by a “FiL.L. statement from the keyboard, control returns to the keyboard. 
(In this case, if there are one or more keywords concatenated after ¢ .., the HP-71 executes these 
keywords before returning control to the keyboard.) 











When a subprogram is suspended, executing EH[) SUE from the keyboard terminates the subprogram, 
releases any local variables and memory associated with the subprogram, and affects control of execu- 
tion in one of the following two ways: 


- If the subprogram was called from another program, execution returns to that program and is 
suspended at the statement following the 





If the subprogram was called from the keyboard, control returns to the keyboard. This means that 
if you concatenated one or more keywords after “FiL.i., those keywords are not executed. 





You can use EHD in place of EHD SIE to end a subprogram. Also, EHD!) SUE operates in the same 
way as EHC if no local environment exists. 


Related Keywords 





























ee 
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ENDLINE ENG 





and ’ statements. 





EMG (engineering format) sets the engineering display format (ENG mode) and the number of signifi- 
cant digits to be displayed (or printed). 







































@ Statement M Keyboard Execution soes 
O Function 1 CALC Mode | > Statement ™@ Keyboard Execution 
| Operator @ IF...THEN...ELSE O Function CALC Mode 
i O Operator M IF...THEN...ELSE 





ENDL INE 






number of 
een ENG 
string 





Examples Examples 





Ci TE 








Input Parameters 






Description 


0 through 11. 









Input Parameters 






number of digits Numeric expression rounded to an 


integer. 











Hem Description Hestrichon® Default: A value less than 0 defaults to 
endiine string String expression. Up to three characters. : A value greater than 11 defaults to 
Default: CR/LF (carriage return/line . 
feed). 
Comments 





The specified string is appended to the output of each Fi statement whenever either of the 


following two conditions exist: 
¢ The statement is not terminated by a comma or semicolon (, or : ). 
e An end-of-line sequence is sent to the printer. 


EHMCLIHE without a string expression restores the normal CR/LF end-of-line. 


Related Keywords 


PRINT, PRINT USTHG. 
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ENG (continued) 


Comments 


Display format statements control the format setting for displaying numbers. The display setting 
remains in effect until you execute another { ; STO statement. 








In £ format the displayed value appears as 
(Sign) Mantissa E (Sign) Exponent, 
where, for normalized numbers, 


1 <= mantissa < 1000, 





: format, the HP-71 displays one ae digit more 
i; statement. For example, | = produces the 


and the exponent is a multiple of 3. In EHS 
than the rounded integer value you specify in the E 
following four-digit outputs: 











If a displayed value has an exponent of —499, it is displayed in * format to the number of digits 
specified in the EM statement. Denormalized numbers have a mantissa of less than 1. 


Related Keywords 
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EPS 





ef (epsilon) returns the smallest positive, normalized number that the HP-71 can represent (1.0 
E—499). 


O Statement M Keyboard Execution 





@ Function M@ CALC Mode 
q Operator M@ IF...THEN...ELSE 
EPS 
Examples 





Comments 


The value of EF is the “underflow threshold.” 


Related Keywords 
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ERRL ERRM$ 





st * * . acs , 
‘1. (error line) returns the line number where the most recent program error or warning occurred. * (error message string) returns the message text of the most recent error or warning. 








Ol Statement ™ Keyboard Execution Ol Statement M Keyboard Execution 
™@ Function M CALC Mode mM Function O CALC Mode 
Ol Operator @ IF...THEN...ELSE 


Ol Operator @ iF...THEN...ELSE 





| 








Examples Examples 
DISF “Error oon line": ERRL C EF=ERRMS 
Comments 
Comments £ returns the message text identified by the number of the most recent error (ER FH). If no 





error or warning has occurred since the last memory reset, EF FM is zero and EFF MS returns the 


The current EF FL value is affected only by errors and warnings occuring during program execution. 1) stri 
null string. 


An error occurring in a subprogram sets EF:FL. equal to the appropriate line number in that 


subprogram, and not the line number of the main (calling) program. 
Related Keywords 


ERRL, ERRH. 























102 


ERRN 





(error number) returns the number of the most recent error or warning. 





O Statement M@ Keyboard Execution 

M@ Function M@ CALC Mode 

1 Operator @ iF...THEN...ELSE 
Examples 

Ci 





ot 
Th 
TT 


Comments 


Both syntax and run-time errors update the number returned by ERFH. If no error or warning has 
occurred since you initialized your HP-71, ERR returns &. 


Related Keywords 
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EXACT 


calibrates the system clock and tells the HP-71 that the time currently stored is the correct 


time. 







@ Statement M Keyboard Execution 
O Function [1 CALC Mode 


11 Operator 


Examples 


@ iF...THEN...ELSE 





ESACT 


Comments 





EXACT sets the Exact flag (—46), and directs the HP-71 to compute an internal adjustment factor 
that is used to continuously update a fast- or slow-running clock. The recommended use of EXFICT is 
as follows: 


1. After either powering up your HP-71 or performing a level three reset, execute SETTIME to set 
T to set the Exact flag and begin the first adjustment 








period. 





2. Following an interval of several days, weeks, or months, use Ff ~ and/or SETTINE one or 

more times to correct the clock. The HP-71 accumulates all corrections except multiples of a half 
TIME statements). Ensure that the clock time is correct by 
comparing it to a reliable time information source. Then execute EsACT. 











Note: A loss of precision occurs if the corrections made between executions of E*ACT do not 
correspond exactly to the true time. However, the longer the interval between executions of 
EACT, the smaller this precision error will be in proportion to any error resulting from a slow or 
fast clock. Thus, correcting the clock after several weeks gives better results than correcting the 
clock after only one day. 
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EXACT (continued) 





The interval between two £#4T commands is termed an adjustment period. Executing E* 
affects the adjustment period as follows: 


e Recomputes the adjustment factor based on: 
e The current adjustment factor. 
¢ The time corrections accumulated during the current adjustment period. 
e The length of the adjustment period. 


e Begins a new adjustment period. 


If the absolute value of the computed adjustment factor (af;) is in the range 0 < af, < 10, an 


trvailic RAF (error 27) condition occurs. 


To access the adjustment factor, refer to the AF keyword entry. 


Note: The internal clock uses the Exact flag. The /nexact flag is a math flag and has no relationship to 
the Exact flag. 


Related Keywords 


RQUUST, AF, SETTIME. 
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EXOR 





: (exclusive or) generates the logical Exclusive Or of its operands. 







| © Statement @ Keyboard Execution 
| O Function mM CALC Mode 
@ Operator M@ iF...THEN...ELSE 


E> 
Examples 





Input Parameters 


operand Numeric expression. 


Comments 











Subject to operator precedence. 





The operands of EF are considered to be logically false if 
zero and logically true if nonzero. The possible results of 
this operation are summarized in the table to the right. 





ce [ne 


False False 
False True 
True False 
True True 







EOF has the same precedence as (Ff, which is the lowest 
of all operators. 


The precedence of EF in relation to the HP-71’s other operators is described under “Precedence of 
Operators” on page 317. 


Related Keywords 


AHO, HOT, OF. 
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EXP 


EXPM1 





EXF (natural antilogarithm) returns the number e = 2.718281828... raised to the power given by the 
argument. 


ExFM1 (natural antilogarithm minus 1) returns the value of e* —1. 







| O Statement M Keyboard Execution 
Oh Statement Keyboard Execution . 1 Function M@ CALC Mode 





@ Function CALC Mode | (1 Operator @ iF...THEN...ELSE 
Ol Operator IF... THEN... ELSE , 
© O 
PE )—+O o 
Examples 
Examples 








Input Parameters 


Description Restrictions 


Input Parameters 


a ee 
: argument 


Related Keywords 









Comments 


This function allows for an accurate evaluation of the quantity e~ — 1, which is useful for values of x 


EXPMI, LOG, Li that are close to zero. 





Related Keywords 
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EXPONENT 





returns the exponent of its normalized argument. 


O Statement M@ Keyboard Execution 
® Function M@ CALC Mode 
(1 Operator @ iF...THEN...ELSE 





[one —+()—+[araenene | +O) 


Examples 


THEE 





Input Parameters 


tem | Description Restrictions 









Comments 


E“FOHENT enables you to perform extended range computations that might otherwise produce an 
underflow or overflow. For a finite nonzero argument, the result is an integer in the range —510 
through 499. £ i » or EXPOMEHT <-> returns -IHF and sets the DVZ (division-by- 
zero) exception flag. 





Related Keywords 
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FACT 


FACT (factorial) returns the factorial of a nonnegative integer argument. 





OO Statement Keyboard Execution 
@ Function CALC Mode 
Ol Operator IF... THEN... ELSE 
© 0) 
Examples 





ations = "!SFACTCHS. 


Input Parameters 


ee 
argument Numeric expression. Nonnegative integer less than or 
equal to 253, or equal to Inf. 


Comments 









FACT returns a value of type REAL. 


The factorial of a positive integer is the product of all positive integers less than or equal to that 
integer. The factorial of 0 is defined as 1. The factorial function overflows for finite arguments greater 
than 253. However, 
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FETCH 





displays any line in the current program file for editing, and is nonprogrammable. 


M Statement M Keyboard Execution 
MO Function 1 CALC Mode 
O Operator @ IF...THEN...ELSE 


GEE} 








identifier 


Examples 





Input Parameters 


Description Restrictions 
Any valid line number or label 
reference. 


Fetching a line sets the file pointer to that line and allows you to edit the line. 










statement Line number or label of a program 
identifier statement. 


Comments 


If a line number or label reference is not specified, the current line is displayed. If the line number is 
not found, the HP-71 displays that line number followed by the cursor. This allows you to create a new 
program line. In a suspended program (SUSP annunciator displayed), executing FETCH without an 
argument displays the line containing the next statement to be executed. 


If a specified statement label is not found an error occurs. 


Related Keywords 


FETCH EE‘Y, LIST. See also the descriptions of the and [Vv] keys in the HP-71 Owner’s Manual. 





FETCH KEY 





displays a specified key assignment for editing, and is nonprogrammable. 





mM Statement M Keyboard Execution 





Ol Function C1) CALC Mode 
OL Operator @ IF...THEN...ELSE 
x 
Examples 


FETCH EEY "A® F 





Input Parameters 


ee ee 
Less than five characters. 





String expression. 


Comments 


FETCH EE‘ retrieves the character string assigned to the specified key. The string is displayed in 
one of the following formats: 


{ 


e Direct execution: DEF EE‘ key name. assigned string: 
e Typing aid: DEF KE‘ key name, assigned string; 


e Immediate execution: DEF EE‘ key name, assigned string 


If no string has been explicitly assigned to the key, the computer displays DEF EE‘ key name. (For 
further information concerning these formats, refer to the DEF KEY keyword entry.) 


The key displays the string assigned to the next key you press. The string remains in the 
display as long as you hold the key down. When you release the key, the display returns to its original 
state. If the key is unassigned, the HP-71 displays LINASSIGHER. 


Related Keywords 
DEF KEY, LIST KEYS, (view). 
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FIX 


I (fixed format) sets both the fixed display format and the number of fractional digits to be dis- 
played (or printed). 












@ Statement @ Keyboard Execution 
Ol Function C1 CALC Mode 
OO Operator @ oiF...THEN...ELSE 
FIX 
Examples 


Restrictions 


number of Numeric expression rounded to an integer. | 0 through 11. 
fractional digits Default: If the value is less than zero, 

Fis uses zero; if the value is greater 

than eleven, F i» uses 11. 





Comments 


Display format statements control the format for displaying numbers. The display setting remains in 
effect until you execute another Fis, », =C1, or STO statement. 





In Fix display setting the displayed or printed value appears as: 
(Sign) Mantissa. 


The mantissa appears rounded to d places to the right of the decimal, where d is the specified aoe 
of digits. While the fixed display format is active, the HP-71 automatically displays a value in 2! 1 
format, rounded to d places past the decimal, in either of the following two cases: 





e If the number of digits to be displayed exceeds 12. 


¢ If a nonzero value rounded to d places past the decimal point would be displayed in fixed display 
format as zero. 





Related Keywords 





| 
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I 


FIX (continued) 
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FLAG 


1 returns the current value (0 or 1) of the specified flag, and optionally sets or clears the flag. 





1 Statement ™@ Keyboard Execution 
M@ Function M@ CALC Mode 
11 Operator @ IF...THEN...ELSE 


Ie = new ; 
flag value 





Examples 


cj 





J=FLAG COMP , 83 


Input Parameters 


es 


flag number Numeric expression rounded to an If you do not enter a new flag 
integer. value, the range is —64 through 63. 
If you enter a new flag value, the 
range is —32 through 63. 


new flag value Numeric expression. None. 





Comments 


If you do not specify a new flag value, the flag value remains unchanged. Otherwise, the HP-71 sets the 
specified flag to 0 or 1, according to whether the new flag value is zero or nonzero. 


You can use FL.AG to set, clear, test, save, and restore any user or system flags numbered greater than 
— 33. 


Related Keywords 


DFLAG, OVE, TMs, IVL, OVE, SFLAG, UWF. 
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FLOOR 





: returns the greatest integer less than or equal to the argument. 








Ol Statement M Keyboard Execution 

! > Function ™@ CALC Mode 

1 

| [1 Operator M@ IF...THEN...ELSE 
© @ 

Examples 





Input Parameters 


a 





argument Numeric expression. 


Comments 


If the value of the numeric expression is an integer, that value is returned. If the value of the expres- 
sion is not an integer, Fi.{:0/ returns the greatest integer value less than or equal to the expression. 
For example: 





ert £1.35) returns 1. 
er ~i2 returns -1i. 
oF :¢-1.5% returns -2. 


if and IT are identical functions. 





Related Keywords 


PEEL, FR, THT, IPF. 
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FN 


FH (function) transfers program execution to the specified user-defined function and may pass param- 
eters to that function. 


O Statement M@ = Keyboard Execution 
@ Function M@ CALC Mode* 


1 Operator O IF...THEN...ELSE 


*Multiple-line user-defined functions cannot be used in CALC mode. 


numeric 
variable name 


variable name 












SESE} 


parameter 


Examples 


Fy 


£ 


“os Yo + PHP CA, BLS) FHE = © + ' 


PRIHT AS; FHOSCRS, YEo FHHS = ESCie, 267 


Restrictions 


None. 


Input Parameters 


es ee 


variable name Numeric or string variable name. 

















actual parameter Numeric or string expression. None. 


Comments 


When invoked in an expression, a function is evaluated and its value is returned to that expression. In 
a user-defined function definition, FH is used in the left-hand side of an assignment statement to 
assign the value to be returned from the function to the expression that invoked the function. A user- 
defined function can be used in either a running program or a statement executed from the keyboard. 
(Use the [IEF FH statement to create user-defined functions.) 


The actual parameters must be of the same type (numeric or string) as the corresponding parameters 
(formal parameters) in the [/EF FI statement. All actual parameters are evaluated, then passed as 
values. 


117 
FN (continued) 


The referenced function must be in the current program scope. If you execute the user-defined func- 
tion from the keyboard, the computer searches only the main program or subprogram in the current 
file, depending upon which environment is currently active. If the currently active environment pro- 
gram contains more than one user-defined function with the same name, Fi uses the one on the 
lowest-numbered line. 


For further information concerning environments, refer to “Scope of Environments” on page 314 and 
to your HP-71 Owner’s Manual. 


Note: It is possible for a subprogram to contain one or more user-defined functions having the same 
name as a function in the main program. In this case, if you (1) suspend program execution while in 
the subprogram and (2) execute the user-defined function from the keyboard, Fi uses the function 
on the lowest-numbered line in the subprogram. 


Related Keywords 


PPE fr Ej EY BEE PPE EP 
LiF Pid, EMLE Ukr 
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FOR...NEXT 





: is used with HE*7 to define a loop that is repeated until the loop counter exceeds the specified 


value. 





@ Statement @ Keyboard Execution 
C1 Function (1 CALC Mode 
C1 Operator O IF...THEN...ELSE 


loop 
counter 









program 
segment 

loop 
NEXT 


Examples 
FOR Ks 
FOR I = 





Input Parameters 


ee ee 


loop counter Simple numeric variable. 














initial value Numeric expression. 





final value Numeric expression. 





step size Numeric expression. 


Default: 1. 
Any number of contiguous program lines. 












program 
segment 
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FOR...NEXT (continued) 


Comments 


General Operation. The loop counter is set to its initial value when program execution encounters 
the FGF statement. Each time execution encounters the corresponding T statement, the step 
size is added to the loop counter, and the resulting new loop counter value is tested against the final 
value. If the new loop counter value does not exceed the final value in the direction indicated by the 
step size, the computer executes the loop again, beginning with the statement immediately following 


the FGF statement. If the new loop counter value exceeds the final value in the direction indicated by 








the step size, the computer exits from the loop and continues program execution with the statement 





following the HE#7T statement. Refer to the loop test that is described under “Operating Details,” 
below. Notice that the step size can be positive, negative, or zero (which results in an infinite loop). 
Whenever you do not specify a step size, the HP-71 uses a default step size value of 1. 


Operating Details. The HP-71 uses the following loop test to determine whether to execute the 


program segment between the FOF and HET statements: 





If (loop counter - final value) * SGN(step size) <= 0 then execute the program segment; else 
transfer execution to the statement following the corresponding HE 7 statement. 


When the loop is initialized, the loop counter is assigned its initial value, and the preceding loop test 
is then performed to determine whether the FMF ...HET program segment should be executed or 
bypassed. 


The initial, final, and step size values for a loop are determined (initialized) when program execution 
enters the loop. If you use a variable or expression for any of these values, you can change that variable 
or expression value after the computer initializes the loop without affecting how many times the loop 
is repeated. However, changing the value of the loop counter after the computer initializes the loop 
affects the number of times that the loop will be repeated. 


The loop counter variable is allowed in expressions that determine the initial, final, or step size values. 
However, the value of the loop counter variable is established before the HP-71 computes the final and 
step size values. 





If you use G7 to exit from a loop before the exit condition is satisfied, the loop counter contains 
the value it had at that time. 


FOR-NEXT loops can be nested. 


When the loop control values involve NaN or Inf there are exceptions to the loop test. For example, if 
the initial value, final value, or step size has the value of NaN upon loop entry, then an Wnor ds 
(error 20) condition occurs. If the IVL trap value is “2,” then the loop counter is set to NaN and the 
program segment between FiiF and HET is executed at least once. 
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FOR...NEXT (continued) 


Related Keywords 
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FP 


FF: (fractional part) returns the fractional part of a numeric value. 









O Statement M Keyboard Execution 
@ Function M CALC Mode 
O Operator B@ IF...THEN...ELSE 
© © 
Examples 















amen [amecoman ie 


Comments 
The returned fraction has the same sign as the argument. For example: 


e FFei.3° returns . 3. 
e FF«-i returns -#. 


e FF«-1.5% returns -. 5. 


Related Keywords 


iC F PHA ees 
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FREE PORT 






Ee T switches the RAM in a port from main RAM to independent RAM status. F! 
is nonprogrammable. 





mM Statement M Keyboard Execution 
[ Function O) CALC Mode 
QO Operator @ IF...THEN...ELSE 





Input Parameters 
Description 


port specifier Numeric expression truncated to two 
digits after the decimal point. interpreted 
as p.dd, where: 


p = port number. 
dd = device number. 





Comments 





Operation " separates a RAM from system memory and prepares the RAM to receive 
and maintain files independently of the computer’s main ow If onere is not enough memory avail- 
able to remove the RAM, the computer displays an ? “si (error 24) message. 
Following execution of # you can remove the RAM from the HP-71 without disrupting 
the computer’s memory nae eetod (Removing a RAM from the computer without first separating 
it from system memory by using can cause a td condition). 














Note: Executing FREE FURT changes the system configuration. That is, when you execute 
FREE FORT, all file pointers are reset, the workfile becomes the current file, and all FGF ... 
HET loops are terminated. 
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FREE PORT (continued) 


Port Information. Port 0 contains the HP-IL port and four internal memory modules. Ports 1 
through 4 are the four ports in the front of the machine, numbered from left to right. Port 5 is the 
card reader slot. 


The device number (dd) is the position of a plug-in device in a device chain. 


Related Keywords 
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GDISP 


GOISE (graphic display) sets the dot pattern in the display according to a specified string. 









M Statement HM Keyboard Execution 





O Function { CALC Mode 
0 Operator @ IF...THEN...ELSE 
Examples 





Input Parameters 


a 


bit pattern String expression truncated to 132 SG 


characters or extended with nulls to 132 
* sets the HP-71’s liquid crystal display bit pattern (but does not affect the display buffer con- 






characters. (The display is composed of 
132 columns containing 8 dots per column.) 






Comments 





The LCD window consists of a field of 132 dot columns. Each column contains eight dots. The HP-71 
displays information by turning on various dots. Any character in a GOI!I SF string has a character code 
that can be represented as an eight-bit binary number. (Refer to “HP-71 Character Set and Character 
Codes” on page 322.) Each character in a GOiISF string corresponds to one column of dots in the 
display; each bit in the character’s binary representation corresponds to one dot in that column. The 
least significant bit of a binary character code defines the top dot of that character’s display column; 
the most significant bit defines the bottom dot of the display column. For example, Gf I SF uses the bit 
pattern for the character “A” (binary code: 0100 0001) to affect a display dot column as shown on the 
facing page. 
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G DISP (continued) 


0100 0001 
| PS A display of this column would 
show the first and seventh dots. 


Notice that the 1’s in the binary code correspond to the displayed dots and the 0’s correspond to the 
undisplayed dots. 








A&G :- string character can be either a character you type in from the keyboard or a character 
specified by &HE#. 


The GO1F string is a one-dimensional array of bytes used to determine the dots to turn on for a 
graphic pattern you want to place in the display. The character code for the first character defines the 
first dot column in the display, the second character defines the second column, and so forth. The 
least significant bit of each character defines the top dot of that display column and the most signifi- 
cant bit defines the bottom dot of the column. For example, the following illustration shows the result 
of executing RHEECied> & % ; RHEE Cleo: 


























126 
G DISP (continued) 


01111100 CHR$(124) 
01100100 d 
01010100 T 
01001100 L 


— CHR$(124) 


(Least Significant Bit of Each Column) 





(Most Significant Bit of Each Column) 


(;011 SF redefines all dot columns in the display, regardless of the HIHOOW setting. However, by using 
GOISF and HIMOGM prior to executing DIF, you can “lock” a bit pattern in a subsection of the 
display. (That is, you can protect a GO1I5F dot pattern in a designated portion of the display from 
being cleared by subsequent executions of DI SF. 





Where a { created symbol is not protected by a } li setting, the symbol remains in the 
display until either some operation sends a character to the display or you press a key while the 
computer is waiting for an input. 


Related Keywords 
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GDISP$ 


GOISF£ (graphic display string) returns a 132-character string reflecting the bit pattern in the LCD 
display: 







O Statement M Keyboard Execution 
@ Function 1 CALC Mode 
1 Operator @ iF...THEN...ELSE 


Examples 





A#=GOLSFS GOISP Gf 





Comments 


The first character of a GO.ISF# string corresponds to the first dot column of the display, and the 
132nd character of this string corresponds to the last dot column of the display. For any GO1SF char- 
acter, the bits in that character’s binary code represent the dots in the corresponding display column. 
(Refer to “Comments” in the GDISP keyword entry.) 


Executing GfilSF'£ displays the current GLIISF# string (leading and imbedded nulls are ignored). 
Executing GOISF GOISE# displays the dot pattern specified by the current GOISF# string. In 


the following program example, GEISF# is used in a loop to obtain the character string from the 
current display for use in the next display. 


10 REM PISTON PROGRAM 


20 GDISP CHR$(255) & CHR$(255) Displays a solid vertical bar that is two columns 


wide. 
30 FOR | = 1 TO 60 
40 GDISP CHR$(24) & GDISP$ 


Begins countup loop. 


Appends column corresponding to CHR#¢24" to 
current display, which, on the first pass through the 
loop, is composed only of characters resulting from 
execution of line 20; on subsequent passes through 
the loop, is composed of all characters previously 
specified in both line 20 and in the loop. Effects are 
to build on CHE#¢2552 image and scroll result- 
ing image to the right. 
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GDISP$ (continued) 


50 NEXT | 
60 FOR | = 60 TO 1 STEP —1 
70 GDISP GDISP$[2] 


80 NEXT | 
90 GOTO 20 


Related Keywords 


GOPSF. 


Terminates countup loop. 
Begins countdown loop. 


Shortens by one column the displayed image created 
in the first loop, and scrolls image one column to the 
left. 


Ends countdown loop. 


Repeats program. 
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GOSUB 


GOSUE (go to subroutine) transfers program execution to the subroutine beginning at the specified 
statement. (The specified statement must be in the same program or subprogram as the GOSLIE.) The 
FETURH associated with a GOSUE statement returns the program exeuction to the statement immedi- 
ately following that GOSUE. 


HM Keyboard Execution 


[1 CALC Mode 
M@ IF...THEN...ELSE 





Examples 
GOSUE i186 "PLOT" 
GOSUE COMPUTES GE 





Input Parameters 


ee 
statement Line number or label of a program Any valid line number or label 
identifier statement. reference. 


Comments 





If you execute GOSUE from the keyboard with another keyword concatenated after GOSUE, the 
computer 


1. Executes the referenced program segment. 


2. Executes the statement concatenated after GOSIJE (only if the called program segment ends with 
RE TUR). 


3. Returns the computer to keyboard control. 
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GOSUB (continued) 


However, if GOSUE execution is suspended and then resumed, upon encountering a FETIIFH the com- 
puter halts without returning to the statement concatenated after GOSUE. 

All variables in a program are accessible to any subroutine within that program. Also, changing the 
value of a variable during execution of a subroutine within that program changes the value of the same 
variable in the main program. 


Related Keywords 





Re TUR, 


ii ; 
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GOTO 


When executed in a program, GOTO (go to statement) transfers program execution to the specified 
statement. When executed from the keyboard, {IT positions the HP-71 to the specified statement. 









| mM Statement ® Keyboard Execution 





_ O Function O CALC Mode 
C1 Operator @ iF...THEN...ELSE 
Examples 





Input Parameters 


ee ee 
statement Line number or label of a program Any valid line number or label 
identifier statement. reference. 


Comments 
The specified line number or label must be within the current program scope. 





GOTO is frequently used as follows: 
e In a running program to perform unconditional branching. 
e From the keyboard to: 


e Commence execution from a particular statement using or (when the program is 
suspended). 


e Position the computer to a particular line in order to edit that line. (To view and/or edit a line 
within the current file, but outside of the current program scope, use FE 7H). 


(Executing G07 from the keyboard displays the SUSP annunciator and sets the suspend statement to 
either the first statement in the specified line or the first statement following the specified label. Also, 
the line containing the suspend statement becomes the current line.) 
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GOTO (continued) HTD 


Related Keywords HTC (hexadecimal string to decimal) converts a string argument representing a hexadecimal number to 
a decimal number. 





C T, FET . Refer also to the description of the key in your HP-71 Owner’s 

Manual. 
1 Statement M@ Keyboard Execution 
B® Function 1 CALC Mode 
Ol Operator @ iF...THEN...ELSE 





hexadecimal 
HTD Y—e( (ay ovate | QO) 


Examples 





Input Parameters 








Item Description Restrictions 


L 
| hexadecimal value | String expression containing hexadecimal Up to five uppercase or lowercase 
| digits. digits. 


Comments 


A typical usage of HTE: is to convert a hexadecimal address in conjunction with [TH#, ADO, 
FEER$, or FORE. 


HT£& is a numeric function that accepts a string expression as input. The string expression must rep- 
resent a hexadecimal integer value in the range 0 through FFFFF. Any string expression having more 
than five characters or containing a character that is not a hexadecimal digit causes an error con- 
dition. A null string also causes an error condition. 


Leading zeroes in the string expression will be accepted, although they are not necessary. 


Related Keywords 


ADORS, OTH, FEER, PORE. 
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IF... THEN...ELSE 





provides conditional execution. 













@ Statement 
O Function 








*Following (only). Refer to ‘‘Further Restrictions’ on the next page. 





logical statement 
expression identifier 
ory 


declaration 


executable 
statement 





Examples 


AS=CAT#CI) @ IF THEN 0 








Input Parameters 








ELSE 





@ Keyboard Execution 
[1 CALC Mode 
Ol Operator @ IF...THEN...ELSE* 












aia 


declaration 


executable 
statement 











Item Description 


Restrictions 





logical expression Numeric expression evaluated as true if 
non-zero and false if zero. 


statement Line number or label of a program 
identifier statement. 
executable Executable BASIC statement. 


statement 


label declaration Quoted or unquoted string followed by a 








io J 





None. 


Any valid line number or label 
reference. 


Any statement legal in an iF 
construct. (Refer to ‘‘Further 
Restrictions,’’ on the next page.) 


Any valid label. 
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IF... THEN...ELSE (continued) 


Comments 


General Operation. If the logical expression evaluates to a nonzero value, it is considered true, and 
program control is transferred to the statement immediately following T Execution of state- 
ments following THE! continues until the computer encounters either £1. or the end of the line 
(unless a GET unconditionally branches execution to another statement). If the logical expression 
evaluates to zero, it is considered false, and execution is either transferred to the statement immedi- 
ately following ELSE ELSE is not used, to the next program line. 















Note: A logical expression can be constructed with numeric or string expressions separated by rela- 
tional operators, as well as with a numeric expression. 





i or £ 


A line number or label reference immediately following ELSE is considered to be an “im- 
plied Go and execution is transferred to the specified statement. 








“99 
wy 









Further Restrictions. Most BASIC statements are legal following or ELSE. However, 
FOR T, DATA " , and, generally, any nonexecutable statements are illegal after T f 


| ; 





rile rd, i H 


or 


An implied (12F is not legal immediately following THEH or ELSE, but is otherwise legal in an 


IF construct. 
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IMAGE 


& to control the format of 





: and F 





is used in conjunction with & 
displayed and printed output. 





H Statement O Keyboard Execution 


QO Function O CALC Mode 
Ol Operator O IF...THEN...ELSE 





format 
string 
















IMAGE "Third Guarter", 3 


TMAGE 


ra, EITM SS 








Input Parameters 


ee 


format string Refer to “Using [MAGE Symbols to 
Control Output’’ on the next page. 















page control item Refer to ‘“‘Page control symbols’’ on page 


138. 






Comments 





TI is the last keyword recognized in a program line. Since the @ symbol is a valid I} 
symbol, there can be no statements concatenated after . Also, an I . statement cannot 





contain a trailing remark, as inclusion of ! generates an error. 





137 


IMAGE (continued) 





To be executed properly by GISF iG i USTHG, IMAGE must be the first state- 
ment in a program line. Although you can enter a program line having IMAGE as the last statement 
in a multiple-statement line, program execution does not access an IMAGE statement in this posi- 


tion, and causes an error. 


You can place a program line containing IMAGE anywhere in a program, as location with respect to 
CiSF USIMG or FEINT USIHG is not significant. During program execution, I -E state- 
ments are ignored in the same way as F'E* statements. 





Using IMAGE Symbols to Control Output. 


Format String: 








: multiplier | 





The use of field specifiers in DISF USING or FEIHT USING statements is shown on the next 
page. Also, in the following discussion, multipliers are represented by n. 
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IMAGE (continued) IMAGE (continued) 








Several IMAGE symbols can be used with a multiplier, as shown in the syntax diagrams. (A multi- e Special output symbols: 
plier is a numeric constant in the range 1 through 9999.) Ke Compact field. Displays/prints a number or string in current display format, 


¢ Carriage control symbol: Although this symbol is the first encountered in the format string, it is with no leading or trailing blanks. 


not acted upon until all other output has been processed. H Same as £, except the European radix (,) is substituted for a decimal point 


# Suppresses the automatic output of the end-of-line sequence at the end of the in numeric output. 


output list. FE Displays/prints a single character. The number to be output is rounded to an 


integer and the least significant eight bits of the number are ‘sent. That is, a 
modulus (256) is performed. The £ symbol is equivalent to CHF 


¢ Page control symbols: 





Page control item: 


Supression field. Causes the computer to evaluate the corresponding variable 
without displaying or printing the result. For example, the statement 








pee eet CISe JE, i,2,3,4 
display 
124. 


Note: Editing symbols may precede or follow any IMAGE character (except #). ¢ Editing Symbols: 


ne DISF USTHG sends a carriage-return, line-feed to the display. FR IHT 
LIS IHG sends an end-of-line sequence to the printer device. 
ne Sends a form-feed to the output device. 





¢ Grouping symbols: 
nea Parentheses are used to delimit field specifiers and to group several fields for Note: Editi f MAE ch 
replicated output. There is no limit, except for the amount of memory avail- pte Editing: Symbols may precads of fellow: any: allie Ey character (excent st) 
able, to the number of levels of nested parentheses. ; ; 
. ns Displays/prints a blank. 


n "chars." Displays/prints the characters contained in the quotes. Any accompanying mul- 
tiplier must precede the leading quote(s). 


e String Field Symbol: 


n a Displays/prints a string character. Generates trailing blanks if the specified 
number of characters is greater than the number available in the corresponding 
string. If the field specifier becomes exhausted while the corresponding string 
still contains characters, those characters are ignored. 
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IMAGE (continued) 


e Numeric Field Symbols: 








Continue at 
extension A. 


Continue at 
extension B. 






8B 


Note: Editing symbols may precede or follow any IMAGE character (except #). 
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IMAGE (continued) 


e Digit specifiers: 


nt Displays/prints one digit. Replaces a leading zero with a blank. If the number 
is negative, but no sign symbol is specified, the minus sign occupies a leading 
digit position. If a sign is displayed, it “floats” to the left of the leftmost digit. 


Any editing symbols preceding the first {! specifier are also “floated” to the 
left of the leftmost digit (or sign, if appropriate). 


nk Same as for [!, except leading zeroes are replaced with “”. Since blanks are 
not filled, no symbols float to the leftmost digit. 
ne Same as for #, except leading zeroes are displayed. 
e Sign specifiers: 
= Displays/prints the number’s sign (+ or —). 
i Displays/prints the number’s sign if negative, and a blank if positive. 
No more than one = or i is allowed per numeric field. 
e Radix specifiers: 
Displays/prints a decimal point radix. 
Fi Displays/prints a comma for the European radix. 
e Digit separators: 
c Displays/prints a comma as a digit separator. 
F Displays/prints a decimal point for the European digit separator. 
e Exponent specifier: 


E Displays/prints £ with a sign and a three-digit exponent. (Leading zeroes in 
the exponent are displayed.) 


formatted by a new field. There are two types of field specifiers: 


¢ Output Field: Consists of numeric, string or special specifiers, all requiring items from the output 
list. 


e Editing Symbol Field: Consists of blanks or quoted characters that do not require an output item. 
A special case of this type is the null field, which consists of either a pair of adjacent commas or a 
pair of parentheses that do not enclose any characters. 
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IMAGE (continued) 


Bach field terminates when it encounters a Field Delimiters 
delimiter. Delimiters indicate that formatting is 
completed for an output item, whether or not the 
entire item was used. The chart to the right illus- 





Delimiter* 









The usual way to separate two field 






trates the five field delimiters. specifiers. 
ne Page control character (output EOL 
sequence). 
nt Page control character (output form 
feed). 
nt Left parenthesis. 






Right parenthesis. 













*The rn indicates that the symbol can be preceded by a multiplier. 





When the HP-71 executes © : LTHG or | r USING, it sequentially accesses the items in 
the output list; one for each output field in the IMAGE list. If the computer encounters a field that 
does not require output items (editing symbol field), the field is acted upon without accessing the 
output list. 


The processing of field specifiers stops when the computer encounters an output field having no 
matching output item. If the output fields are exhausted while output items remain, the fields are 
reused, beginning with the first field. 


IMAGE Overflow. An IMAGE overflow results when a numeric item requires more digit places to 
the left of the decimal point than are provided by the field specifier. This occurrence is reported in the 
same manner as math overflows; that is, as an error or as a warning, depending upon the value of the 
OVF trap. With either (DEFAULT GFF or TEAF: F2=6, the IMAGE overflow is reported as an 
error, thus halting execution. With CEFALLT or DEFAULT EXTEHO, or with TEAP Se Our > 
set to i or 2, the IMAGE overflow is reported as a warning. After the warning is displayed, the 
numeric field is filled with * symbols and execution continues. 








A minus sign takes a digit place if you do not specify ! or =, and can generate unexpected overflows 
of the field specifier. If the number contains more digits to the right of the decimal point than the 
field specifier, it is rounded to fit the field specifier. 


String Field Output. If a string is longer than the field specifier, it is truncated, and the rightmost 
characters are not sent out. If the string is shorter than the specified field, trailing blanks are used to 
fill out the field. 
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IMAGE continued) 





IMAGE syntax Details. ane HP-71 checks the syntax of an IMAGE statement only when | 
| i Li ; ' statement. ae those parts necessary to exhaust 
the output list are checked, since not all of the field specifiers may be used if there are fewer items in 
the output list. Thus, a syntax error near the end of the format string is not reported if there is no 
output item to access it. In addition, since the computer processes field specifiers sequentially, several 
items may be generated before a syntax error is reported. 





Tt 


Typing for Readability. You can type | symbols in upper- or lowercase characters. A space 
imbedded anywhere in an E statement is ignored, except where the space is imbedded in a 


quoted series of characters. 





of 






Carriage Control Symbol. Only one occurrence of the # carriage control symbol is allowed in any 
format string, and only as the first nonblank character in that list. The carriage control symbol must 
be followed by a delimiter. 


Parentheses. Although parentheses allow repeated output with multipliers, they always function as 
delimiters for a new field. When building the format string, you should include parentheses only when 
nested for field delimiters. For example, in each of the following program segments, the [15F 
LIS 1HG operations are the same, except for the parentheses appearing in one of the two IMAGE 
statements: 


e Program segment: 


10 DISP USING 100; "LUNCH’,"FRIDAY’ 
20 DISP USING 200; "LUNCH’,"FRIDAY’ 
100 IMAGE AA3”."AA , 2X 
200 IMAGE AA3(".”")\AA , 2X 


Program output: 


Lu., 
LU... FR 


GOR RG oa TO 





e Program segment: 


10 DISP USING 100; 5280, 1760 
20 DISP USING 200; 5280, 1760 
100 IMAGE 3ZCZZZ, 2x 
200 IMAGE 3(ZCZZZ), 2x 
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IMAGE (continued) 


Program output: 





e Program segment: 


10 DISP USING 100; 1.25,6.50 
20 DISP USING 200; 1.25,6.50 
100 IMAGE ’$"DDD.DD , 2X 

200 IMAGE (°$")DDD.DD , 2X 


Program output: 


pei 
tat 


m 
un itt 
Tt 


Multipliers. Multipliers are integer values in the range 1 to 9999. A multiplier of 1 is ignored in all 
cases (that is, no error will be generated in cases where a multiplier is not allowed). Only the following 
types of symbols allow a multiplier. 


e Editing symbols: *, "chars.". 

e Page control symbols: -,!@. 

e Symbols specifying individual characters in an output item: [, #, = and A. 
¢ Left parenthesis ©. 


For a description of the preceding characters, refer to “Using IMAGE symbols to Control Output” on 
page 137. 


You can replicate any field by enclosing it in parentheses with a preceding multiplier. Thus, since the 
symbols ,H,E, and * are fields specifying entire output items, they must be enclosed in parentheses 
in order to be replicated. For example: 


oF. 






The Special Output Symbols H, K, B, and *. A special output specifier, because it uses an entire 
item, comprises an entire field. H, -:, and “ can be used to generate string or numeric items; E can be 
used only with numeric items. 


The # and H symbols generate an item in the current display format, except that no leading or 
trailing blanks are generated. k) and H differ only in the type of radix symbol for numeric output. 
uses the decimal point, whereas H uses the comma (European radix). 
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IMAGE continued) 


numeric item n must-be in the range 
—1048575 <= n <= 1048575. 


The * symbol allows output items to be skipped. Any such item is still evaluated, which allows the HP- 
71 to execute a function without displaying or printing the returned value. This is useful if the evalu- 
ated function changes the state of the machine, such as changing the display device. 


Examples Using H, K, B, and *. 
Program segment: 


10 DISP USING 100; 583.5,247.3,"June”,20 

20 DISP USING 200; “Blue”,"Red’,”Hat”,Shirt’ 

30 DISP USING 300; 65,66,67,CHR$(65),CHR$(66),CHR$(67) 
100 IMAGE H,3X,K 

200 IMAGE K,X,* 

300 IMAGE 3(B),”=”,3(A) 


Program output: 











For the next example, assume a plug-in ROM provides the FE} statement to change ink colors on a 


printer. 


Program segment: 


10 PRINT USING 100; FNX(B,C), A 

20 STOP 

100 IMAGE %, “Account #”,6Z,X,”Updated” 

200 DEF FNX(B,C) 

205 REM PEN 1 = black ink; PEN 2 = red ink 
210 IF B>=C THEN PEN 1 ELSE PEN 2 

220 FNX=B-—C 

230 END DEF 
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Printer output with B=33, C=22, and A~118042: 
cf (in black ink) 





Printer output with B=18, C=22, and A~118042: 





(in red ink) 


Editing symbols. The symbol * and quoted characters can be imbedded within any other field 
specifier without delimiters. 


Editing Example. 


Program segment: 


10 DISP USING 100;2592, "Tues’” 
100 IMAGE DDD’ dollars and "DD” cents.”,2XK"day” 


Program output: 





2S oollars ard 3 


Numeric Specifiers. The symbol £ sends out a digit, with leading zeroes replaced by blanks. 
The + symbol generates a digit, with each leading zero replaced by #. 

The = symbol generates a digit, with leading zeroes shown. 

Numeric Specifier Example. 


Program segment: 


10 DISP USING 100; 12.4, 10.1, 6 
100 IMAGE DDDDD,2xX, «****,2X,ZZZZZ 


Program output: 





Le #E#e1e & 





Digit output before the radix can be specified with a [, #, or =, but not a mixed set of these symbols. 
The only exception is that a = can always occupy the unit digit’s place. This unit digit = is only 
necessary with decimal output, since integer output will always show a digit in the unit place. 


Sign specifiers (2 and M) can be imbedded anywhere within a numeric field. Only one = or * is 
allowed in each numeric field. 
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If 3 or M is not specified, and the number is negative, then the minus sign will take up one digit 
position before the radix. 


Radix specifiers (. and F) can only be followed by [ symbols if digits are to be shown after the 
decimal point. Only one decimal (.) or F is allowed in each numeric field. 


Digit separators (C and F’) can appear anywhere in a numeric field. They cannot be adjacent to (or 
separated only by editing symbols from) other digit separators, radices, exponent specifiers, or 
delimiters. If a © or F appears when leading zeroes are being output, the symbol causes output as 
shown below: 


Program segment: 


10 DISP USING 100;2 
20 DISP USING 200;2 
30 DISP USING 300;2 
100 IMAGE DC3DC3D.3DCD 
200 IMAGE *C3*C3*.3DCD 
300 IMAGE ZC3ZC3Z.3DCD 


Program output: 





When used with [! symbols, a digit separator within 
leading zeroes is replaced with a blank. 


When used with + symbols, a digit separator within 
leading zeroes is replaced with a #. 





When used with = symbols, a digit separator within 
leading zeroes appears as specified. 


The £ symbol allows output to “float” past blanks to the leftmost digit of the number, or to the radix 
indicator. The allowable floating specifiers are =, I, % and quoted characters that precede all digit 
specifiers in the field. These characters will float over any blank digit positions or separator positions 
before the first nonzero digit is encountered. When the first [i is encountered, the floating capability 
is lost for any following =, fi, %, or quoted characters. However, an implied negative sign always 
floats past all blanks. 
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IMAGE (continued) IMAGE (continued) 





Examples. In the numeric field, 4 and Im characters are right-justified, and will not be divided by editing 
Program segment: symbols. All excess positions in the numeric field are filled with blanks, regardless of the type of 


symbol you use. (For example, = and # symbols are filled with blanks when generating 4 or 

















10 DISP USING 100; 1234.56, —65.8 im? output.) Generating output with [ symbols disables the floating characteristics 
20 DISP USING 200; 1234.56, —65.8 of all editing symbols. 
30 DISP USING 300; 1234.56, —65.8 
100 IMAGE "$’6D.DD, X, "$"6D.DD Program segment: 
a tee beeen - wna Note: In the following program, line 10 sets the IEEE traps to allow NaN, Inf, and error on overflow. 
Assigning the trap value to T in each case simply avoids displaying the value returned by * Fe. The 
Program output: variable T is otherwise not used in the program. 
$le34.56 $-65,98 
#€1234.56 -#65, 80 10 T=TRAP(IVL,2)@T =TRAP(DVZ,2)@T =TRAP(OVF,0) 
Fl,234,.56 $ -65.88 20 SFLAG(—1) !SET QUIET TO SUPPRESS WARNINGS 
Ss. , : . 30 DISP USING 100;SQR(—1),1/0 
At least one digit specifier must precede the E symbol. The maximum exponent value allowable in 40 DISP USING 110:—123,—Inf 
an oP i ; THG or FREINT US I HG output is +999. This is only obtainable through display form 50 DISP USING 120:NaN 
manipulation, since, for normalized numbers, the maximum exponent value obtainable through 100 IMAGE Z.D,3”.”,3DC3D.2D 
arithmetic operations is +499. 110 IMAGE ”{”S4D":”2D"}” 
Program segment: 120 IMAGE 2D 


10 DISP USING 100; 1E—480 
20 DISP USING 100; 1E—481 ; 
100 IMAGE 520DE Nan. eee Inf 
to-Lieare -~Inrfi 
ERR LSG@:ITMAGE Ovrl 


Program output: 


eee output: 


totai?, 





E929 Related Keywords 





#... (Generates 525 + symbols.) 





NaN and Inf. Numeric field specifiers display the numeric values Har and Inf if there are at least 
three numeric specifiers in the field (four in the case of — Ir). Numeric specifiers include the symbols 
O, 2, #, 3, M,C, F, ., B, and E. For NaN and Inf output, each specifier corresponds to one position, 
except that E corresponds to five positions. Where there are insufficient positions to print or display 
the characters, the result depends on the current trap setting. That is, if the OVF trap is set to 0, the 
HP-71 displays the IMAGE O-f1 (error 47) message. Otherwise, the computer generates a warning 
and fills the numeric field with + symbols. 
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INF | INPUT 


- enables you to assign values to program variables from the keyboard. 











O Statement @ Keyboard Execution m Statement M Keyboard Execution 
M@ Function M@ CALC Mode O_ Function CL] CALC Mode 
C1 Operator @ IF...THEN...ELSE (1 Operator M@ IF...THEN...ELSE 











i ao 
Examples 









Comments 


Any (non-NaN) number x is less than or equal to Inf. Most arithmetic functions accept Imf as an 
argument and process it according to standard arithmetic rules. For further information, refer to the 
descriptions of the individual functions in this manual, or to your HP-71 Owner’s Manual. 











Operations that cause an overflow can result in an infinite value if you set the overflow trap (OVF) to Input Parameters 

2. Also, operations that set the divide-by-zero (DVZ) exception create Ir: or ~In¢ if you set the os 

DVZ trap to 2. Item Description Restrictions 

Related Keywords prompt string Quoted string. Cannot contain the same quote 
Default: “Y ” character as that used to delimit the 


string. 





: default string String expression. None. 
Defauit: Null string. 
variable specifier Numeric variable specifier or None. 
string variable specifier. 














| 


is 











152 
INPUT (continued) 


Comments 
You can assign values from the keyboard to any numeric or string variable, substring, or array element. 


Prompts. Executing 1 HFT displays the input prompt (‘"). If the last OISPF or GISF USTHG state- 
ment was terminated (EOL suppressed) with a comma or semicolon for a delimiter, the prompt is 
appended to the specified display message. If the last such statement did not terminate (EOL not 
suppressed) with a comma or semicolon delimiter, the “ prompt appears on a line by itself. 


Responding to Prompts. You can respond to a prompt in the following ways: 


e Enter a list containing one or more numeric expressions, string expressions, or unquoted strings in 
any combination. The individual items must be separated by commas and must match the IHFUT 
list variables in number and type. To enter an unquoted null string, key in two. consecutive 
commas. 


e If the input statement specifies a default string, you can either accept the string by pressing 
or change the string by editing it, then pressing [ENDLINE]. When you execute an 
IHF LUT prompt containing a default string, the HP-71 displays this string immediately after the 
prompt, with the cursor positioned at the first character in the string. For example: 


Program Segment: 
100 INPUT "CURRENT YEAR: ”,”1984’; A$ 
a 
Input Default 
Prompt String 


Prompt: 


{ 
Display 
Cursor 








If the iT statement requires a string, but the item you key in is not a string, the computer 
interprets the item as an unquoted string. 


If you provide an improper number of inputs or enter an item that cannot be interpreted as a numeric 





expression when Iti requires a numeric input, the computer gives an error message and again 


prompts you for an input. If this occurs, the cursor appears on the input character at which the error 
was detected. 
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INPUT (continued) 





T statement, if you press , the computer: 


* Terminates the IHFLT operation without changing the variables in the input list. 


When prompted by an I 


« Continues program execution with the next statement. 


Executing INPUT and Other Operations Simultaneously. While the IHFLUT prompt is dis- 
played, the following operating conditions are active: 


e The command stack is always active during IHFUT execution. (Pressing (9][CMDS] is not required 
to initiate command stack operation.) You can use the and keys to move up and down in 
the command stack. The same command stack is used for keyboard input regardless of whether the 
computer is in BASIC or CALC mode, or is executing an IHFLIT statement. 


e INPUT activates the command stack at the first level, so pressing will initially display the 
second level. To view the first level of the command stack, press (¥] or (9)LV). 


If you press a direct execute user-defined key, the computer ignores the display and uses the input 
of that user-defined key as the response to the IHFUT prompt. 


¢ The key and the [9] key sequence are active during INF LIT execution. 


e Pressing clears the input buffer (if not already clear) or pauses the program (if the input 
buffer is already clear). Thus, pressing twice in a row during execution of IHFLT interrupts 
program execution. If you then continue the program, the INPUT statement is reexecuted. 


e Pressing [RUN], [SST], or during INFLUT execution has the effect of pressing [ENDLINE]. 


e The keyboard buffer allows you to “type ahead” in anticipation of a prompt if you know what 
input will be required by that prompt. As soon as the prompt appears, the key(s) held in the 
buffer are accepted as the input, and program execution continues. 





¢ The HP-71 temporarily suspends any (iH TIMEF operations that come due during execution of 
an IHFUT statement. After (1) you complete the input process and (2) the computer assigns all 


values (and unless a multiple-line user-defined function is invoked), any suspended (1H TIMER 
operations are processed. 








e An error can cause an (iii ERECE branch. If there is no active {11 ERROE statement, and if 
an input response results in an input error, the computer prompts you to reenter all variables in 
the input list. 


The HP-71 automatically turns itself off after ten minutes of inactivity. To continue execution, press 
to turn the computer on, then press to reexecute the IHF'LUT statement. 


Related Keywords 





r, HIOTH, 
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INT 


THT (integer < argument) returns the greatest integer that is less than or equal to the argument, and 
is identical to FLOOF, 





O Statement M Keyboard Execution 
@ Function HM CALC Mode 
C1 Operator @ iF...THEN...ELSE 
o O 
Examples 





THT Oswego 





Input Parameters 


Ce [ie 
argument Numeric expression. 


Comments 














If the value of the numeric expression is an integer, that value is returned. If the value of the expres- 
sion is not an integer, I//7 returns the greatest integer value less than or equal to the expression. For 
example: 






'3 returns 1. 
i= returns ~i. 


'> returns -=. 


Related Keywords 





LeBel, Pe 
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INTEGER 


* allocates memory for integer variables and arrays. 













a Statement @ Keyboard Execution 
Ol Function LC) CALC Mode 
LJ Operator M@ IF...THEN...ELSE 





Oise] 6 













numeric 
variable 


INTEGER 







Examples 





IMTEGER I 


Input Parameters 











numeric variable Letter followed by optional digit. None. 












Current @F 
to 65535. 


Numeric expression rounded to an 
integer. 







' dimension limit 1 } 
dimension limit 2 





Comments 


; BE. The 
dinamo’ limits are evaluated at creation time. The lowest-numbered subscript in any dimension | is 0 
E setting when the array is created. All elements are initial- 








or 1, depending on the GF TIGH & 
ized to zero. 
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INTEGER (continued) 


If IHTEGER specifies a simple numeric variable that already exists, the variable is reinitialized to zero. 
Array variables are redimensioned, but not reinitialized to zero (unless the data type is changed). If 
IHTEGEF expands an array, it also initializes all newly-created elements in the array. Notice that 
redimensioning does not necessarily preserve an element’s position within an array, but does preserve 
the sequence of elements within an array. Refer to “Declaring Arrays (DIM, REAL, SHORT, IN- 
TEGER)” in section 3 of the HP-71 Owner’s Manual. 





The following table indicates the conditions that apply to i} F variables and arrays: 


Integer Numeric Variables 


Initial Value of Variables 

Integer Range 

Maximum Number of Array Dimensions 
Maximum Dimension Limit 


Memory Usage in Bytes: 
e Simple Variable 9.5 
e Array 3*(dim1— base+ 1)*(dim2—base+1)+9.5 





Related Keywords 


DIM, RERL 








1) Statement 
- Mi Function 
Ol Operator 


INX 


Examples 
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INX 


‘ (inexact) returns the number of the inexact result flag (—4). 


M Keyboard Execution 
M CALC Mode 
@ IF...THEN...ELSE 
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IP IVL 


(invalid operation) returns the number of the invalid operation flag (—8). 

















O Statement W Keyboard Execution Ol Statement M Keyboard Execution 
@ Function M CALC Mode @ Function M CALC Mode 
Ol Operator @ iF...THEN...ELSE 1 Operator M@ IF...THEN...ELSE 
© © m 
Examples Examples 


Restrictions 





Comments 

The returned value has the same sign as the argument. For example: 
e TFei.32 returns i. 
e TFco-i> returns -1. 


eTFi-i.3% returns ~i. 


Related Keywords 





ETL, Fi 
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KEYS 


KE‘! # (key string) returns a string representing the oldest key or keystroke combination currently held 
in the key buffer, and removes that key or keystroke combination from the buffer. 





O Statement M Keyboard Execution 

@ Function [1 CALC Mode 

C1 Operator @ IF...THEN...ELSE 
Examples 





Comments 


The key buffer can contain up to 15 keys or keystroke combinations. The format in which the key 
data is returned is the same as that for DEF KEY, KEY OOH, and KEYOEFS. If the key buffer is 
empty then the null string is returned. 


The string returned for a given key is determined as follows: 





e If there is a single ASCII character that uniquely identifies the key, £‘;# returns this character. 
For example, ( identifies the (Q) key and 4 identifies the [9]-shifted (Q] key. 


e If the key is an [f}- or (9]-shifted key, and the key’s primary function is uniquely identified by a 
single ASCII character, then #E''# returns a two-character string. This string consists of ¢ or 2 
followed by the corresponding primary character. For example, 34 is the [G]-shift of the (0) key. 


e If neither of the above apply, KE returns # followed by the decimal-numbered key code for 
that key. For example, if you press during execution of the following program, the HP-71 
displays #46. 





10 DELAY 0,0 Suppresses display time (because any keys held 
in the display buffer at the start of a (IF dis- 
play are cleared). 

20 FOR I=1 TO 100 

30 DISP KEY$; Adds the key designation to the current display. 


40 NEXT | 


The _« statement does not affect the returned string. 





Related Keywords 
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KEYS (continued) 
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KEYDEF$ KEYDEF$ (continued) 


Related Keywords 





KEY OEF£ (key definition string) returns the redefined value of a key. 








Oh Statement HM Keyboard Execution 
@ Function 11 CALC Mode 
Ol Operator M@ IF...THEN...ELSE 





Cane) OE -+O 


Examples 
AS=KEVYOEFS¢" a" s 
IF KEVYDEFS¢"#43"90C1,1] # "U" THEM OISP “Attn key has been 


redefined" 


Input Parameters 


Description Restrictions 








key name String expression. Less than five characters. 





Comments 


The returned string has the same format as is seen by pressing . 





I + uses the same format as [EF * to specify a key name. The first character in the 
returned string indicates the type of definition for the key. The following list describes the possible 
first. characters: 





e ; : Nonterminating. 
e Blank: Terminating. 
e ; : Direct execute. 


e Li : Key is not redefined. 


The remaining characters in the string describe the key redefinition text. 


ery 





returns the message 





If a specified key has not been redefined, 
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KEYDOWN 





{ returns either a 0 or a 1, depending on whether a key is being pressed. 


rm 


O Statement M Keyboard Execution 
@ Function O CALC Mode 
Ol Operator @ IF...THEN...ELSE 









THEM 


THEH 





Input Parameters 


key name String expression. Less than five characters. Also refer 
to ‘‘Comments,’’ below. 
Comments 


EE‘'OOWM enables you to test for either any key being pressed or a specific key being pressed. 



















¢ To test for any key being pressed, use | 
keys are not ignored by this #E' TM! 


[ik without any key parameter. The [f] and (9] 
i option. 





¢ To test for a specific key being pressed, use KE‘ Ef with a parameter specifying the desired 


key. Parameter options are as follows: 


e Key name expressed as a character: For unshifted keys identified by a symbol, such as a letter 
or the key, enter a quoted string containing only that character. Where a shifted or 
unshifted key enters a symbol having a corresponding ASCII code, you can specify that key 
by using CHE #«n2, where n is the ASCII code for that symbol. 
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KEYDOWN (continued) 


e Key name identified by key number: If the first character of a multiple-character key name is 
#, KEY DOWN interprets the string as a key number. You can use this method to specify any 
unshifted key. The key numbers are as follows: 


rerninoes [towne [noe 
1 through 56 Unshifted keys [a], ets 


The preceding parameters use the same formats as those used with [ *'. If you use the null 
string fora KE { parameter, the HP-71 returns zero. 


















The HP-71 accepts FE li (without a parameter) in CALC mode. 


Related Keywords 





KEY, KEYS 


mb Py 








166 1Be 


LEN 


LC 





LC (case lock) toggles between the uppercase lock and the lowercase lock on the keyboard. LEH (string length) evaluates the specified string expression and returns its length. 









H Statement M@ Keyboard Execution Statement HM Keyboard Execution 
( Function CO CALC Mode —™ Function O CALC Mode 
O Operator @ sIF...THEN...ELSE 4 O Operator B IF...THEN...ELSE 


string 
LEN -—>()—+|_ expression L—-Q) 





Input Parameters 








Comments string expression | Refer to the Glossary. 





During usual keyboard input the primary alpha keys enter upper case letters and the (9]-shifted alpha 
keys enter lower case letters. The |.{ statement is used primarily for switching these assignments, as Comments 


follows: ; 
enclosed spaces are included in the returned value. For example, executing 


Hi citraiee: Ua potirne 45 





e Executing ..£& OH sets system flag —15, which assigns the lowercase characters to the cor- 
responding primary alpha keys and assigns the uppercase characters to the (9]-shifted alpha keys. 





Leading, trailing, and 
LEM oc" blather "* returns i%. 








e Executing Lm F clears system flag —15, which assigns the uppercase characters to the cor- 
responding primary alpha keys and assigns the lowercase characters to the [9]}shifted keys. 


e Executing Li switches the current setting of system flag —15, which exchanges the current 
uppercase and lowercase key assignments for the primary and [(9]-shifted alpha keys. You can 
switch this same flag from the keyboard by pressing the key. 
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LET 





* is the assignment statement, which is used to assign values to variables. 


@ Statement ™@ Keyboard Execution 
Function mM CALC Mode* 
[1 Operator M@ IF...THEN...ELSE 


* You can use only the implicit form of LET in CALC mode—for example, F:=*. That is, the explicit form of LE T— for example, LET 
FA=F—is not allowed in CALC mode. 


numer ic numeric 
variable specifier expression 
a string ie at string al 
variable specifier expression 
numeric numeric 
variable expression 
string 
variable 














FN 


string 
expression 





Examples 





Input Parameters 


ee 


numeric variable Refer to Glossary. 
specifier 


numeric Refer to Glossary. 
expression 


string variable Refer to Glossary. 
specifier 


string expression Refer to Glossary. 
numeric variable Refer to Glossary. 
string variable Refer to Glossary. 
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LET (continued) 


Comments 


If the specified variable does not exist, it is created when the HP-71 executes the corresponding LET 
statement. If the variable is an element of a nonexistent array, the HP-71 creates that array (where the 
maximum allowed indices are 10 and minimum allowed indices correspond to the current OF TIOH 
EASE setting). A string variable created by LET has a default maximum length of 32 characters. 


Thus, larger maximum lengths must be explicitly dimensioned. 


A numeric variable of type SHORT causes rounding (according to the current round-off setting) to 
five significant decimal digits. However, the calculation itself is performed in 12-digit arithmetic. A 
numeric variable of type INTEGER causes rounding to an integer (according to the integer rounding 
method). If, after rounding, the result has more than five digits, the stored value will be + 99999 or 
INF, depending on the current trap settings for the math exception flags. 


In addition to assigning a numeric result to the specified variable, the HP-71 stores the result in the 
register reserved for use by FES. (The value stored for use by FES is the result calculated prior to 
any rounding for SHORT or INTEGER.) 


In a user-defined function having multiple statements, the function name itself is a legal variable. 
Therefore, whatever value is in this variable when the HP-71 finishes executing the corresponding 
function is the value returned by that function. 


A string value replaces the current value of the specified string variable. If the new value exceeds the 
string variable’s maximum length, the replacement is not performed, anda String Ovfl (error 
37) condition occurs. 


The following illustrates how the HP-71 handles string assignments: 
Statement: A#="HECOEFGHTJELMHOP" 
Output: HECDEFGHIJELMHOPF 


Statement: H#C057="TUNE" 
Output: ABCOTUME 


Replaces any earlier H# string value. 


Replaces portion of A# that begins with posi- 
tion 5. (TU! becomes the new end-of-string, 
starting at position 5.) 


Statement: Af05.17="EFGHIJE* ORS" Inserts string between positions 4 and 5. No- 

Output: ABCOEFGHIJE SC ORS TUM tice that second substring index is less than 
the first (by an arbitrary amount), which 
causes the HP-71 to insert the substring into 
the existing string instead of overwriting part 
of that string. 
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LET (continued) 


Statement: Af0 12,123 7="LNHOF" 
Output: ABCOGEFGHIJELMH 
Statement: A#C2, 22 ]="-* 
Output: A-H 

Statement: RFCS 7="i2s" 
Output: A-iW 123 





Statement: A#="" 
Output: —Null— 


Related Keywords 


IHTEGER, REAL, RES, SHORT. 


Replaces a two-character substring with a five- 
character string. 


Replaces a 21-character substring with a 1- 
character string. 


Uses a “blank-filling” technique that allows 
the i232 string to be appended. 


Sets A# to null. Note that a null value differs 
from a blank space value. 
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LINPUT 


(line input) assigns an entire line from the display to a string variable. 





M Statement M Keyboard Execution 
O Function [1 CALC Mode 
[1 Operator @ IF...THEN...ELSE 


string 
a se eee 
prompt 
default 
string 














LINPUT 






Examples 





L= 





Seriter lie 





Input Parameters 





Item Description Restrictions 


Cannot contain delimiting 





prompt string Quoted string. 











Default: “7 ” character. 
default string String expression. None. 
Default: Null string. 
string variable Refer to Glossary. None. 
specifier 
Comments 


LIHPFLIT is similar to the IHF LUT statement in that it causes the HP-71 to pause execution, activate 
the keyboard, and allow you to enter a variable. L IHFLIT assigns the resulting line to the specified 
string variable. |. I HF'‘LIT is distinguished from IHF LT in that it allows punctuation, whereas IHF LT 
treats punctuation as delimiters. (Unlike the IHF UT statement, the string you enter with LIHFLT is 
interpreted literally, and not as a string expression.) 





172 


LINPUT (continued) 


You can respond to a L.IHFLiT prompt in either of the following ways: 
e Enter any number of characters. 


e Enter an “execute only” string. (That is, a string that has been used with a colon to redefine a 
key.) Notice that if you enter an execute only string, the HP-71 ignores any other characters that 
may already be in the display. 


For information concerning prompts and default inputs, refer to the comments provided in the INPUT 
keyword entry. 


Related Keywords 


IHPUT. 
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LIST 





displays the specified BASIC or KEY file. 


@ Statement M Keyboard Execution 
O Function Oh CALC Mode 
11 Operator @ IF...THEN...ELSE 





== pn Ce 
specifier 






or key number 





Examples 
LIST LIST MEAN: PORTCS3 
LIST KEYS,15.165 LIST Af, 225 
ia LIST 
HEC 





Input Parameters 


String expression or unquoted string. File name with optional device 
Default: Current file. specifier. 


1 through 9999. 






' file specifier 



















_ Start line or key 
: number 


Integer constant identifying a program line 
or key number. 
Default: First program line or key 
assignment in file. 












| final line or key 
number 


Integer constant identifying a program line 
or key number. 
Default: Start line or key number, if 
specified; otherwise, last program line or 
key assignment in file. 


Start line or key number through 
9999. 
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LIST (continued) 


Comments 





General Operation. Specifying a file that is not a BASIC or KEY file generates an I: 
File T : (error 63) condition. 





Executing LIT KEES results in a listing of the current key assignment file, k == (if present). 


Specifying a single line or key parameter lists only that line or key assignment. If you specify a range 
and the HP-71 does not find the start line or key number, but does find a higher-numbered line or key 
number within the specified range, the listing begins with that higher-numbered line or key. Execut- 
ing L ’ without specifying any line or key numbers generates a listing of the entire file. 





The current [iEl.A’’ setting determines how long the computer displays each line. 








The current j1f:7H setting determines the width of the display line. 


Interrupting a Listing. To halt a listing and display the cursor, simply press [ATTN]. 


Related Keywords 


DELAY, HIOTH, PLIST. See also the descriptions of FETCH and the [a], (¥], (9) (4), and (9) [y) 
keystrokes in your HP-71 Owner’s Manual. 
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LOCK 


' specifies a password to provide for security against unauthorized use of your HP-71. Anyone 
who turns on the computer will be prevented from using it until they enter the password. 










H@ Statement M@ Keyboard Execution 
O Function [1 CALC Mode 





O Operator @ IF...THEN...ELSE 
Examples 


"Ae LOE He 





Input Parameters 


String expression. 0 through 8 characters. 





Item 





password 





Comments 


The password can be any combination of up to eight letters, numbers, spaces, and symbols. 


Note: Because the lock is absolute, it is recommended that you choose an easy-to-remember pass- 
word. If you cannot enter the correct password, the HP-71 will not respond to your instructions. If this 
situation occurs, you can regain control of the computer only by resetting the computer, which clears 
both the memory and the clock. 






Using LOCK. After initially executing 2° with a password, each time you turn on the HP-71, 
you are prompted by the message fF a==iicr 4%. To unlock the computer, type in the exact password 
that you specified using Lfick, then press [END LINE]. The HP-71 then displays the cursor and you 
can continue with your work. Any attempt to unlock the computer by entering an invalid password 
simply turns off the computer. 





Deactivating LOCK. To deactivate Lf&E, remove the password by entering LC with a null 


argument, as shown in the rightmost statement example, above. (Ensure that there are no spaces be- 
tween the quotes. If a space is included, it will be interpreted as a new password.) 
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LOG (LN) 





& returns the natural logarithm (base e) of the argument. 


Statement @ Keyboard Execution 
Function @ CALC Mode 
Operator @ iF...THEN...ELSE 











Input Parameters 


ee 
Numeric expression. Refer to ‘‘Comments,’’ below. 


Comments 













e Attempting to compute the natural logarithm of zero results ina L 4 (error 12) condition. 





e Attempting to compute the natural logarithm of a negative number results in a L! 
(error 13) condition. 


Related Keywords 
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LOGP1 


LOGP1 (logarithm of (argument +1)) returns In(1 + <x). 





O Statement @ Keyboard Execution 
@ Function ™ CALC Mode 
(1) Operator M@ IF...THEN...ELSE 


RD) Oran} +O 


Examples 








PRIHT “ithooh =" TEs 


Input Parameters 


Numeric expression. 











Item 


Must be greater than —1. 





_ argument 


Comments 
You can use LOGF i to eliminate large relative errors in certain calculations. For instance, LUGF 1 
<1, 2245E-16% is accurate to 12 significant digits, but LH¢i+i.2245E-18% becomes LH 





from the accurate answer, since In(1.00000000012) is quite different from In(1+1.2345E— 10). 


Related Keywords 


EXP, EXFMi, LO. 
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LOG10 (LGT) 





returns the logarithm (base 10) of the argument. 


Statement Keyboard Execution 


Function CALC Mode 
Operator IF... THEN... ELSE 











Input Parameters 





argument Numeric expression. Refer to ‘‘Comments,’’ below. 


Comments 


The following exceptions can occur: 


e Attempting to compute the logarithm of zero results in a Loag¢&: (error 12) condition. 
e Attempting to compute the logarithm of a negative number results in a LOG*nea2 (error 13) 
condition. 


Related Keywords 
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LR 


LF (linear regression) specifies the current linear regression model and computes the intercept and 
slope for that model. The computed intercept and slope are returned in optional variables. 








H Statement @ Keyboard Execution 
1 Function 1) CALC Mode 
OO Operator @ IF...THEN...ELSE 


variable 
slope 
variable 





dependent independent 
variable number variable number 





Examples 





Input Parameters 





















dependent Numeric expression rounded to an integer. Zero through the current = r array 
variable dimension. 
number 





One through the current = 
dimension. 


independent Numeric expression rounded to an integer. 
variable 


array 


number 

intercept Numeric variable specifier. (Refer to None. 
variable Glossary.) 

slope Numeric variable specifier. (Refer to 





variable Glossary.) 
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LR (continued) 


Comments 


L.f specifies the linear regression of the first (dependent) variable on the second (independent) vari- 
able. The intercept and slope are stored in the intercept and slope variables, if present. 


Related Keywords 





PAE Ay 


argument 
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MAX 





(maximum) returns the larger of two values. 







O Statement M Keyboard Execution 
@ Function B CALC Mode 
1 Operator @ iF...THEN...ELSE 


Coa) —+[arainere } +O) renner | +) 


Examples 





Input Parameters 


Description Restrictions 









Item 











Related Keywords 


NIH. 
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MAXREAL 


MANREAL (maximum real number) returns 3. 333359399239 E453, which is the overflow thresh- 
old—the maximum positive finite number that the HP-71 can represent. 

















C) Statement @ Keyboard Execution 

M@ Function HM CALC Mode 

QO Operator @ iF...THEN...ELSE 
Examples 


W=TRAPCUHF, 22 @R=EXPOMEHT <MAXPEAL > -EMPOMEHTOMINREAL?@ TRAP CUME, Lia 
Comments 


The HP-71’s exponent range is —510 through 499 (R=1009). 


Related Keywords 
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MEAN 


| returns the sample mean of the specified variable in the current statistical array. 





O Statement M@ Keyboard Execution 







BH Function M CALC Mode 
11 Operator @ iIF...THEN...ELSE 





number 


Examples 





Input Parameters 


Numeric expression rounded to an Zero through the current =TAT 
integer. array dimension. 
Default: 1. 









variable number 


















Related Keywords 


AGO, CLETAT, CORR 
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MEM MEM (continued) 


NEM (memory) returns the number of available bytes in either main RAM or a memory device. Comments 


The following can help you plan how to use available memory. 





O Statement M Keyboard Execution 
™@ Function ™@ CALC Mode : Bytes Used per Bytes Used per 
INTEGER 9.5 3 +99999 
SHORT 9.5 4.5 5-digit 
Lees gee, eel REAL 9.5 8 12-digit 
(() () STRING 11.5+MAXIMUM LENGTH  2+MAXIMUM LENGTH = 





*Any array has a 9.5-byte overhead. 





Examples 





QI 





MER +4% 





Input Parameters 


a 


Numeric expression truncated to two 0<=P<=5 
digits after the decimal point. Interpreted 0 <= dd <= 15 
as P.dd, where: 

P = port number. 

dd = device number. 

Default: Returns current MEM value 
for main RAM. 









port specifier 




























186 187 


MERGE MERGE (continued) 





integrates a portion of the file you specify into either the current BASIC file or the system Comments 
is file, depending on the type of the specified file. 
. : _ : If you specify a BASIC file, it is merged into the current file. f you apecity a KEY file, it is merged 











into the system kf ¢ file. Any other file type results in an Imvalid File Ture (error &) 
™@ Statement M Keyboard Execution condition. If the specified file is a KEY file and the system : = file ioes not already auist: ME 
QO Function CO CALC Mode creates it. 
(1 Operator @ IF...THEN...ELSE 











E inserts all line numbers or key assignments into their proper positions in the destination file. 
If a line or key number in the file to be merged already exists in the destination file, the line or key 
number in the source file replaces the corresponding program line or key assignment in the destina- 
tion file. In a BASIC file, you can prevent any duplicate line numbers from being replaced in the 





file 
specifier 









start line 
ior key number 








destination file by first renumbering either of the files to ensure that there are no common line 
ee Merging a BASIC file by executing MERGE in a running program performs the merging operation, 
then terminates program execution, releasing local environments and clearing all program control in- 
Examples formation. 
ears MERGE El. 1a. 125 Merging a file does not alter the file being merged. Only the current or : eu file is altered. 
MERGE Ed. & 


Related Keywords 
Input Parameters 





RE MLIAE 

















Item Description Restrictions Ly 
file specifier String expression or unquoted string. File name with optional device 
specifier. 
start line or key Integer constant identifying a program line | 1 through 9999. 
number or key number. 


Default: First program line or key 
assignment in file. 


final line or key Integer constant identifying a program line Start line or key number through 
number or key number. 9999. 

Default: Start line or key number, if 
specified. Otherwise last line or key 
assignment in file. ‘| 
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MIN 





[> (minimum) returns the smaller of two values. 








O Statement @ Keyboard Execution 
@ Function HM CALC Mode 
C1 Operator @ IF...THEN...ELSE 
© © @ 
Examples 








Input Parameters 


argument Numeric expression. 








Related Keywords 


NAG, 
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MINREAL 


MIHREAL returns &,@a@G@ag@0H81E-455, which is the smallest positive number that the 


HP-71 can represent. To return this number, set the underflow trap to 2 before executing 
MHIHREALCTEAFCUHF, 233. Otherwise, executing MIHFEAL generates an underflow exception. 





O Statement B Keyboard Execution 
@ Function M@ CALC Mode 
1 Operator @ IF...THEN...€LSE 





Examples 
W=TRAPCUHF, 23@M=1-EXPONMENT OMINREAL“EPS?@TRAPCUHF, Uo 


Comments 


The value MIHFEAL returns is one example of a denormalized number. (For a discussion of 
denormalized numbers, refer to “Denormalized Numbers and —0” on page 341.) Executing MINREAL 
sets the underflow exception flag (flag —5) if TRAF“UHF > is set to 0 or 1. 


Related Keywords 
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MOD 


MOO’x.y2 (modulo) returns a remainder that is defined by the expression x — y « INT(x/y). 

















= names the system uc 
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NAME 








O Statement M Keyboard Execution 


@ Statement 











M@ Keyboard Execution 
1 CALC Mode 
M@ IF...THEN...ELSE 








@ Function M@ CALC Mode O Function 
C1 Operator M@ IF...THEN...ELSE 1 Operator 
CaO) @ 6 Cie) 
Examples Examples 





Input Parameters 











Description 


Refer to “Comments,” below. 


Item 





argumentt Numeric expression 












String expression or unquoted string. Any valid file name. 









Description Restrictions 


file name 
argument2 Numeric expression. Refer to “Comments,” below. 
Comments 
Comments : , . 
While woerk¢ile is the current file you can easily access it. However, once you move the edit 





1 is similar to & 





and F&!0, and has the following properties: pointer away from iar 





ef 


“X,y2 is periodic in x with period | y |. 





“x;y lies in the interval [0,y) for y > 0 and (y,0] for y < 0. 


e 00 can set the Inexact Result flag (IH). When this occurs, it indicates that the value returned 
by MCC requires rounding in order to fit into a REAL variable. For example, MOD(—E— 20,360) is 
(860 —1E—20), which cannot be represented exactly with 12 digits of precision. 


If either x = Inf or y = 0, an Irvailid Ara (error 11) condition occurs. 


Related Keywords 


RP. 











current file (by executing ELIT ). Assigning a name to wo 
erence it without designating it as the current file. 


files, there is no way to reference the file without redesignating it as the 


ie enables you to ref- 
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NAN 


HFM (not-a-number) returns the value of a Signaling NaN. 


O Statement 


M@ Keyboard Execution 





@ Function ™@ CALC Mode 
O Operator @ iF...THEN...ELSE 
Examples 
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NOT 





performs the logical NOT of its operand. 








OO Statement BW Keyboard Execution 

O Function @ CALC Mode 

M@ Operator @ iF...THEN...ELSE 
Examples 





Input Parameters 














Item 





operand 


Comments 


Operands used with HOT are considered logically false if eieeana 
zero and logically true if nonzero. The table to the right P 
indicates the range of results for HOT. 





True 
ee i 4 False 
The precedence of HUT in relation to the HP-71’s other 
operators is described under ‘Precedence of Operators” on 
page 317. 


Related Keywords 
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NUM 


HliM (number) returns the ASCII character code for the first character of a string. 





O Statement M Keyboard Execution 
@ Function ( CALC Mode 
( Operator @ iF...THEN...ELSE 
om) —-O © 
Examples 





Input Parameters 


ee 


Comments 















HLM returns a decimal number. For example, executing |/ * returns &5. Ifa specified string 


is null, | returns &. 





HLIM is the inverse of the {HF function. 





Related Keywords 
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OFF, OFF ERROR/TIMER 





o£ F turns off the HP-71. 





OFF ERREGE disables any previous (i F statement, thus returning the computer to its de- 


fault method of error reporting. 





Tif # deactivates the corresponding {}/ TIMER # statement. 










mM Statement ™@ Keyboard Execution 
Ol Function [1 CALC Mode 
[1 Operator @ IF...THEN...ELSE 









-<—— 
(#) timer 


number 





Examples 
OFF mer OFF TIMER #Ti#e-3 
OFF TI OFF = 





Input Parameters 











Item Description Restrictions 















i‘ 


‘ 
; timer number 






Numeric expression rounded to an Timer number 1, 2, or 3. 
integer. 
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OFF, OFF ERROR/TIMER (continued) 


Comments 


The OFF Statement. (FF is equivalent to EE. Executing GFF in a program, then later turning 
on the HP-71 causes program execution to automatically resume with the statement immediately fol- 
lowing the (FF statement. If you execute @FF from the keyboard, any statements concatenated 
after CFF are not executed when the HP-71 is turned on again. 
















The OFF ERROR Statement. In addition to OFF ERROR, any one of the following four operations 
disables a previously executed OH ER FOF statement: 


e Executing EHD. 
e Executing the last statement of a program. 
¢ Editing a program. 


¢ Running another program. 





Timer Control of Program Execution. If the HP-71 activates a timer by executing GH Tit! 


then subsequently executes {iF F, the computer turns itself off as described above. screens when thie 
timer expires, the computer fannie itself on, services the timer, and resumes program execution. 


The OFF TIMER Statement. There are three timers, numbered 1, 2, and 3. When rounded, an 
OFF TIMER number must equal an integer from 1 to 3. 


statement. No further 





the 


IF # statement deactivates the corresponding {} Ti 
aarnipes from that timer will occur until you reactivate it. 





Any of the four operations listed above that disables an (if F statement also deactivates all 


three timers. 


Related Neywords 
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ON ERROR GOSUB/GOTO 


cH ERG causes the computer to execute the specified subroutine or branch when an error occurs 
during program execution. 












a ; Statement CO Keyboard Execution 
O Function O CALC Mode 
Ol Operator @ iF...THEN...ELSE 








GOTO ELS 


Restrictions 


Input Parameters 






















Item Description 
statement Line number or label of a program Any valid line number or label 
identifier statement. reference. 


Comments 
This keyword allows you to design specialized error-handling routines into your programs. 


* condition that traps 





TH is a local declaration that, when executed, activates an 
program errors in the following manner: 
e An condition transfers execution to the specified statement in the same 
way as for a subroutine call. Thus, when execution subsequently encounters a F: state- 
ment, execution transfers to the first statement following the one in which the error occurred. 











e An OH OE "} condition unconditionally transfers execution to the specified statement 
in the same way as for a program branch. 
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ON ERROR GOSUB/GOTO (continued) 


CH ERRCE is subject to the following operating conditions: 


¢ Regardless of the number of errors that occur, an (iH EF RGF declaration remains active for the 
program that executed it until replaced with another (iH EF FOF declaration or disabled with 
an (FF ERRGE statement. 


e ON ERROR and OFF ERROF act locally, affecting only the program or subprogram in which 


they appear. When one program calls another, the computer temporarily suspends any active (Hi 
=RRCiR declaration in the first program until execution returns to that first program. 








FR GOSUE routine itself contains an error, program execution halts. If an 6 EF- 
! routine contains an error, an infinite loop can occur between the statement in error and 
the routine specified by GH ERR GoTo. 











* deactivates (#4 





Executing (FF EF 
When using OH ERP it is sometimes helpful to also use ERFL, ER FH, or ER FM in the specified 


iH ERROR subroutines or branches, which produces the following results: 


EFL: Returns the most recent line number in error. 
ERFH: Returns the most recent error number. 
EFFI: Returns the error message associated with the most recent error number. 
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ON...GOSUB/GOTO/RESTORE 


OH .. GOSUB and OH ... GOTO transfer program execution to the destination specified by GOSLUE or 
GOTO. OH .. RESTORE resets the FEAQ data pointer to the closest DATA statement following the 
selected statement. 


@ Statement W@ Keyboard Execution 
Ol Function [1 CALC Mode 
O Operator @ IF...THEN...ELSE 


EH 





identifier 






Examples 
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ON...GOSUB/GOTO/RESTORE (continued) 


Input Parameters 

















Item Description Restrictions 
pointer Numeric expression rounded to an 1 through the number of 
integer. statement identifiers listed. 
statement Line number or label of a program Any valid line number or label 
identifier statement. reference. If more than one is listed, 
use . to separate. 
Comments 






The ON...GOSUB and ON...GOTO Statements. executes any of one of sev- 
eral a ibroutines that you have listed by statement identifier in an + statement. The 
HP-71 uses the current value of the pointer in C to peach a “abatement identifier from 
the list. That is, executing OH ... GOSUE causes the eomnputer to: 








1. Determine the specified pointer value. 





2. Use the pointer value as a position in the Gh : address list. A pointer value of 1 
corresponds to the first statement identifier; 2 corresponds the the second statement identifier, 
and so on. 


3. Execute the subroutine that begins at one statement specified by the statement identifier listed 
in the selected position in the | list. 








Following an statement, when a running program encoun ak statement, 


program arecution velar to the statement following that : statement: 









rf) transfers execution to another location in program memory in the same way as {i}... 
, but has no provision for a subsequent return of execution. 


ane ON...RESTORE Statement. {+}... RESTORE specifies a statement in the same way as (1H . 

EB and GH .. GOTO. If that statement is a CATA statement, the computer then resets the READ 
ne pointer to the first item in that [474 statement. If the specified statement is not a DATA: state- 
ment, the computer resets the FEAL! data pointer to the first item in the first CATA statement that 
follows the specified statement. 








Related Keywords 
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ON TIMER # 


ti TIME # enables one of three individual timers to interrupt a program at the specified time 
interval and cause the specified branching to occur. 






@ Statement 1 Keyboard Execution 
O Function 1 CALC Mode 
O Operator M@ IF...THEN...ELSE 






statement 
identifier 


CH 
OH 


OF TE 





Input Parameters 


a 


1 through 3. 





timer number Numeric expression rounded to an 


integer. 














seconds Numeric expression. 1/32 second through 134,217,727 


seconds. 













statement 
identifier 


Line number or label of a program 
statement. 


Any valid line number or label 
reference. 
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ON TIMER # (continued) 


Comments 


The timer number must be either 1, 2, or 3. The time interval must be specified in seconds. Time 
intervals less than the minimum or greater than the maximum are set to the minimum or maximum, 
respectively. 





When the HP-71 executes Hi T * #, the appropriate timer is activated. When that timer ex- 
pires, program execution transfers to the specified line. Where more than one timer has expired, the 
expired timers are serviced in numeric order. If the timer expires during execution of a program state- 
ment, the transfer does not occur until the computer has completed execution of that statement. 


qT IME # statement deactivates the timer previously activated by the cor- 


Executing the 
H # statement. Any of the following operations deactivates all three timers: 


responding 













e Executing £ wl, or 3 


e Executing the last statement of a program. 
e Editing a program. 
e Running a program. 


Timer Subroutines. When the timer set by an OH TIMER... GOSUE statement expires, program 
execution transfers to the indicated statement and continues. The computer terminates the subroutine 
when it executes a FETIIFH statement. Execution then returns to the statement following the last 
statement executed before the timer interruption occurred, and resumes. Simultaneously, the subject 


timer is reset to the time interval you originally specified in the OHM TIMER... GOSUE statement. 





Timer Branches. When the timer set by an {i} T OTC statement expires: 

e Program execution transfers to the indicated statement and continues. 

e The subject timer is immediately reset. 
Timers continue to run after a program is suspended, but the interrupt does not cause the specified 
branching until the program is resumed. 





Timer Operating Details. If a = or GFF statement within a program turns off the HP-71 
after a timer has been activated, when ‘that imac expires, the computer turns itself on and: 


1. Executes the subroutine or branch epee by the timer. 


2. When is encountered after {i} TIRES sent 
resumes program execution with the frst: Statement {following the 









execution the computer 
; statement. 
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ON TIMER # (continued) 


Timers are global. Thus, after a program has called a subprogram, any timers activated by the calling 
program and expiring during execution of the subprogram are not acted upon until execution returns 
to the calling program. Also, a timer activated within a subprogram supersedes any other timer that 
was activated earlier by another program. 


Related Keywords 


+ 
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OPTION ANGLE/BASE/ROUND 


the subscript lower bound(s) for subsequently dimensioned arrays. GFT 


roundoff setting. 


@ Statement M@ Keyboard Execution 
{) Function O CALC Mode 


11 Operator B 















subscript 
ic: oo base | 


Examples 





Input Parameters 






subscript base 





integer. 


[we |e 


Numeric expression rounded to an 


IF... THEN... ELSE 





EH 
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OPTION ANGLE/BASE/ROUND (continued) 


Comments 


Any GF TIGH EASE setting has a global effect. That is, an GF TION EASE setting has the same 
effect regardless of whether it is executed in a program or subprogram, or from the keyboard. 





The OPTION ANGLE Statement. When executed subsequent to GF TION ANGLE, all func- 
tions that return an angle do so in the specified units, and all subsequently executed operations that 
use parameters representing angles will interpret angles in the specified units. 


Selecting radians setting turns on the RAD annunciator and sets system flag —10. Selecting degrees 
setting clears the RAD annunciator and clears system flag —10. 


The OPTION BASE Statement. Any array you create or redimension after executing 
CF TIOH EASE will have the subscript lower bound(s) specified in that OF TIOH BASE statement. 
However, subscript lower bounds for previously dimensioned arrays will not be changed. That is, chang- 
ing the CF TIOH BASE setting after creating an array does not change the array’s option base. (The 
lowest-numbered element in any array has a subscript of either 0 or 1, depending upon the current 
OFTIOH BASE setting.) 


Executing GF TIGH BASE & clears flag —16. Executing OF TIGOH EASE 1 sets flag —16. 


The OPTION ROUND Statement. Executing OF TIOH FOUND HEAR selects rounding to the 
nearest machine value. Where there is a choice between two values, the even value is selected. 
OPTION ROUHO FOS selects rounding upward (towards +infinity), OF TION ROUHO HEG se- 
lects rounding downward (towards —infinity). OF TIGH ROUNO ZERO selects rounding towards zero 


(rounds the absolute value downward). 
OPTION 
ROUND 


Clear Clear 
Clear Set 

Set Clear 
Set 











PTO RE sets or clears system flags —11 and 
—12 as shown in the table to the right. 











Related Keywords 
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OR OVF 





' (overflow) returns the number of the overflow flag (—6). 


The (iF binary operator performs the logical OR of its two operands. 





O Statement M Keyboard Execution O Statement M@ Keyboard Execution 
O Function M CALC Mode aah @ Function ™@ CALC Mode 


™@ Operator @ IF...THEN...ELSE _ QO Operator @ IF...THEN...ELSE 


Examples Examples 


x TF FLAGS THEN GO 











IF 2=2 OF ASO THEN GO 





POOP, 23 


Input Parameters 


maa a Related Keywords 
Description Restrictions 
IELAG, DEFAULT, DV, FLAG, THE, IML, SFLAG, TRAP, UNF. 
operand Subject to operator precedence. 


0 
1 
1 
1 





Comments 

Operands used with “if are considered logically false if 

zero, and logically true if nonzero. The table to the right 

indicates the range of results for GF. Operand 


OF and EXCF have the same level of precedence, which is F Lett | Right | 


the lowest of all HP-71 operators. (Refer to “Precedence 
of Operators” on page 317.) 





Related Keywords 
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PAUSE 


FALISE suspends program execution. 





@ Statement O Keyboard Execution 

O Function O CALC Mode 

O Operator @ IF...THEN...ELSE 
Examples 





Comments 





In a running program, FAIISE suspends program execution. Subsequently executing {7 or press- 
ing either the key or the key resumes execution at the statement immediately following 
the FAUSE statement. 


Executing EMO, S7OF, or EHD ALL, running a program, or editing a program clears the “sus- 
pended” status (that is, releases local environments and clears all program control information main- 
tained in the computer). 


Note: A suspended program retains any memory allocations it has already estaniisned for local 





variables, pending subprogram calls, subroutine levels, E statements and F HEAT 
statements. 
Attempting to execute FFILISE from the keyboard results in an lilegai Centex (error 79) 
condition. 


Related Keywords 
F, and the and keys. 
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PEEK$ 


FEEEK# returns the contents of a specified section of memory. 







O Statement M Keyboard Execution 
H Function 1 CALC Mode 





Ol Operator @ IF...THEN...ELSE 
(PeEKs)—>(() CO) Q) 
Examples 
Ag = PEER: oe Cl 





Input Parameters 















Up to five uppercase or lowercase 
digits. 
0 through 524,287. 


String expression containing hexadecimal 
digits. 

Numeric expression rounded to an 
integer. 


hexadecimal 
address 


number of nibbles 










Comments 
(error 61) 





Specifying memory that is located in a private file results in a File Ft 
condition. 


Related Keywords 





& TiTust ith 
Fy Cy ris, HY bly 
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PI PLIST 


FI returns a 12-digit value (3.14159265359) representing =. Fil 





:T displays the specified BASIC or KEY file on the print device. 


O Statement Keyboard Execution 


@ Statement ™@ Keyboard Execution 
O Function 1 CALC Mode 
1 Operator M IF...THEN...ELSE 


specifier 


@ Function CALC Mode 
O Operator IF... THEN...ELSE 









Examples a 
tart line 
CaP TED KEYS aay 
Ti weet my !T oO Too 4 iB He final line 
FOR wok To FI wea Er Bd ig 12 (;) or hey number 


Examples 


ra 


4 


Li: 


bent 
ay 
cae | 
cr 
we) 
a 
A 
bed 
a 
mm 
i 
i 


aD 
ce oe 
ent 
mrt cre 
wood 3 
fete 
ead 
rt 
LEE 
re 
Te 


F 
FE 


io 
bt 


ney 


T KEYS 


t 
£ 
m 


Input Parameters 





Description Restrictions 


file specifier String expression or unquoted string. File name with optional device 
Default: Current file. specifier. 


start line or key Integer constant identifying a program line 1 through 9999. 
number or key number. 

Default: First program line or key 

assignment in file. 


final line or key Integer constant identifying a program line | Start line or key number through 
number or a key number. 9999. 

Default: Start line or key number, if 

specified; otherwise, last program line or 

key assignment in file. 
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PLIST (continued) 


Comments 


Operation. The FLI5T operation is identical to that of L151, except the output goes to the print 
device instead of to the display device. 


Specifying a file that is not a BASIC or KEY file generates an Invalid File Type (error 63) 
condition. 


Executing FLIST EES results in a listing of the current key assignment file, k eus. 


Specifying a single line or key parameter lists only that line or key assignment. If you specify a range 
and the HP-71 does not find the start line or key number, but does find a higher-numbered line or key 
number within the specified range, the listing begins with that higher-numbered line or key. Execut- 
ing FLI=7T without specifying any line or key numbers generates a listing of the entire file. 


If the print device is the display, the current [IELAl' setting determines how long the computer 
displays each line. 


The current FiJIfiTH setting determines the width of the printed line. 


Interrupting a Listing. To halt a listing and display the cursor, simply press [ATTN] . 


Related Keywords 


DELAY, EHOLIHE, List, 
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POKE 


FClKE writes to memory at the specified hexadecimal address. 


CAUTION 


Executing FORE can cause a Nemary Last condition. Also, executing FEE for some areas 


of memory can result in a condition from which the only methods of recovery are either to execute 
IHIT= or to remove the batteries. I}173 destroys all files in main RAM. Removing the batteries 
causes a loss of memory in all of RAM. 





@ Statement M Keyboard Execution 
O Function 1 CALC Mode 
O Operator @ IF...THEN...ELSE 





hexadecimal 
(POKE ) ©) 


Examples 





ca 
At 


FOKE "“AFZG", "Sé0E" 


Input Parameters 


hexadecimal String expression containing hexadecimal Up to five uppercase or lowercase 
address digits. digits. 


data String expression containing hexadecimal No restriction on number of 
digits. characters in data. 








Comments 


writes to memory all digits preceding the 
(error 11) condition. 


If there is a nonhexadecimal digit in the data strin 
nonhexadecimal digit, then generates an | 





The amount of data written is limited only by the amount of available memory. Attempting to use 
FEE within a secure or private file results ina File Frsatect (error 61) condition. 
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POKE (continued) 


Related Keywords 


AOOR#, OTH#, HTO, PEEKS. 
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POP 


FOF cancels the pending return of program execution from the current subroutine. 


@ Statement @ Keyboard Execution 


Ol Function O CALC Mode 
O Operator @ iF...THEN...ELSE 


Examples 





FOF 


Comments 


FOF is similar to RETLIFM except that it causes program execution to continue at the instruction 


following the F'tiF statement instead of at the instruction following the calling GOSUE statement. 
(That is, FCF cancels the pending return established by the last GO2UIE statement.) 


Related Keywords 


GOSUB, EFETURE. 
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POS 


FOS (substring position) returns the position of a given substring within a string. 








O Statement ™@ Keyboard Execution 
@ Function O CALC Mode 
(1 Operator M@ IF...THEN...ELSE 











Examples 





— 
“T 





a 
o 


cy. 


Input Parameters 


string searched 


None. 

















String expression. 


substring 
searched for 





String expression. None. 

















start character 
number 


If the rounded value is less than or 
equal to zero, F0= used the default value 
of “1.” 


Numeric expression rounded to an 
integer. 
Default: 1. 







Comments 


Fi searches within the first string for the second string. If the second string is found within the 
first, the starting character position of the second string is returned. 


If the search is to start at a position other than the first character, use the optional third parameter to 
specify the starting position. In the above examples, = SSLPPIS = returns 5, 
which represents the result of a search beginning at character 3 (=) for the character I. 
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POS (continued) 





Fis returns zero when the substring cannot be found. For example: 
e POSC* HAR THOG". "HOG" > returns 5. 
ePOSC) RTHOG"', "FIG": returns 0. 
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PREDV 


FREI (predicted value) returns the predicted value (based upon the current statistical array) of the 
dependent variable, the last LF statement, and the value of the independent variable specified as the 
argument. 













Oh Statement @ Keyboard Execution 
M@ Function @ CALC Mode 





1) Operator @ IF...THEN...ELSE 
© o 
Examples 


Description Restrictions 





Numeric expression. 





Comments 


F / must be preceded by execution of {.& 





Related Keywords 
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PRINT 


FRIHT causes the print items to be sent to the print device. 


BH Statement ™@ Keyboard Execution 


O Function O CALC Mode 
OO Operator @ IF...THEN...ELSE 













Examples 
PRINT I; TABCT +53; "#" 
PRIMT "Hello “:Af:".", "Me 





Input Parameters 


ee 


expression Numeric or string expression. None. 
column Numeric expression rounded to an integer. | Greater than zero. 
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PRINT (continued) 


Comments 


Operation. FFIHT operates in a manner similar to that of [15F. However, FE IHT is not af- 
fected by HIfiTH statements (and, conversely, [I=F is not affected by FH IOTH statements). 


You can use EMDLIHE to alter the string that FF IHT appends to the end of each print line. (The 
default string is the carriage return/line feed.) 


Use of TAB. THE positions FER IHT (and [15F) output to begin at the column you specify. If the 
current column position is beyond the specified TAE column, the computer first moves to the next 
line, then positions itself to the specified column. If the column position value exceeds the current line 
width, the computer reduces the position value by a multiple of the line width (in a manner similar to 
the FEL function), then moves to the reduced column position. 


Related Keywords 


MISPF, EHOLIWE, FRIWHT USTHG, PFRIHT #, PHIOTH. 
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PRINT USING 


FRIHT LUSIHG causes the print list to be sent to the print device in a user-specified image format. 






m@ Statement @ Keyboard Execution 
' O Function O CALC Mode 
| © Operator @ IF...THEN...ELSE 














PRINT USING 


line 
number 
Ps format i 
string 


expression 





Examples 
PRIHT USTHG S88: SS, B45 .58 
PRIHT USING S34: AF 
FRIMT USTHG "ELE, BE 'utpute' 4,2, 2462 





Input Parameters 


Integer constant identifying a program line. 


1 through 9999. 
Refer to the IMAGE keyword entry. 
None. 


















line number 
format string | String expression 
Numeric or string expression. 









expression 











222 223 


PRINT USING (continued) PRINT # 












Comments FE IHT# writes data items to a data file associated with a specified channel number. 
FRIHT USTHG uses a format string to format output items. If there are no output items, there may H Statement M Keyboard Execution 

or may not be any output to the printer, depending on the items in the format string. O Function O CALC Mode 

If FE IHT USING references a line number, an IMAGE statement must be the first statement in C1 Operator Bee AEN ELE 





that line. When executed from the keyboard, the computer searches for an IMAGE statement at the 
referenced line number in the current file. 


If FF IHT USING contains a string expression for the image, that expression must evaluate to a valid 


format string, as described in the IMAGE keyword entry. For example: PRINT # 


aaa 
array 








i Me 
specifier 
"Profit=", F 
The following program provides a further FE IHT USING illustration: Examples 
10 S$= '2X,” & "Today’s” & '”,8A,"$’2D.DD’ Uses string expressions for images. PRIHT #2 FRIMT # A, BE, 0 
20 PRINT USING S$; ” Special”,2.95 References string expression. PRINT #F: 
Today's Special #2,.95 Result of executing lines 10 and 20. 


Input Parameters 





The items in an output list must be separated by commas or semicolons. However, unlike FF 1 HT, 
these punctuation characters have no further meaning in FE IHT USIHG statements. 








Description Restrictions 
Related Keywords channel number Numeric expression rounded to an 0 through 255. 
integer. 
record number Numeric expression rounded to an 0 through 1,048,575. 
integer. The first record of the file is record 
0. 


expression Numeric or string expression. None. 


array specifier Array name followed by an empty set of None. 
parentheses «2 or ©. 3 which indicates 
that the entire array is to be written to the 





IAAGE, FRIAT, PAT 








file. 
bo 
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PRINT # (continued) 


Comments 


FF IHT # writes data items to the file assigned to the specified channel number. The file type can be 
DATA, TEXT, or SDATA. 


If you do not specify a record number, the data items are sequentially written to the specified file 
(termed sequential access), beginning with the current position of the data pointer within the file. 
The HP-71 automatically increases the file size if the end of the file is reached before all data is 
written to the file. If you specify a record number, the file pointer moves to that record and the data 
items are written. This process is termed random access, and can be used with all data file types 
except TET files. (Attempting to randomly access a TE 7 file results in an Irnwalid File 
Typ (error 63) condition. Also, for a file of type DATA or SUATA, specifying a record number greater 
than the last record number in the file generates an Enid of File (error 54) condition.) 





The format of numeric and string values depends upon the types of files to which they are written. 


For information concerning the amount of memory required for various HP-71 file types, refer to the 
information listed under “Files” in the “System Memory Requirements” table that begins on page 330. 


TEXT Files. Every data item written to a text file forms an individual record. The computer writes 
an end-of-file mark when it completes execution of each FF INT # statement. (Only sequential access 
is allowed on a TEXT file—a record number must not be specified.) The computer converts numeric 
data to text form—according to the current display format—before writing the data to the file. 


DATA Files. FE IHT # uses eight bytes of memory to write each numeric value to the file, and uses 
three bytes plus one byte per character for each string. Sequential access starts at the current file 
position, may cross record boundaries, and writes an end-of-file mark after the last data item written. 
Random access writes data items to the specified record number, then writes an end-of-record mark. 
(Random access does not cross record boundaries.) Thus, for random access, all of the data must fit 
into one record. Otherwise, a Fic tis f 1. (error 29) condition results. 





SDATA Files. You can write only numeric data to an SDATA file. Each value uses eight bytes of 
memory. 


Related Keywords 
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PRIVATE 





JATE limits access to the specified file and restricts changes in its protection. 











@ Statement M Keyboard Execution 

O Function O CALC Mode 

O Operator @ iF...THEN...ELSE 
Examples 





Input Parameters 








Item Description Restrictions 
file specifier String expression or unquoted string. File name with optional device 
specifier. 
Comments 


A private file may not be altered, listed, or otherwise read. This means that you cannot use it as the 
destination file in a ! E statement or otherwise modify it. Because of the permanent results of 
executing FRI ', this statement requires that you always specify the name of the file you want 
to make private. 











Note: As an added precaution, only an unsecured file can be made private. 


You can execute and purge an unsecured file that is private. The catalog listing for an unsecured 
private file appears with a F in the protection field. A secured private file can only be executed. In a 
catalog listing, a secured private file appears with an £ in the protection field. Once you make a file 
private, the file remains private. Thus, its protection can only oscillate between the protection types * 
and £. Also, you can designate as private, only the files that you can execute. That is, only executable 


BASIC and BIN (binary) files can be designated as private. 


Related Keywords 
SECURE, UNSECURE, 








226 


PROTECT 





ECT write-protects one track of a magnetic card. 





M Statement M Keyboard Execution 

O Function O CALC Mode 

Ol Operator M@ IF...THEN...ELSE 
Examples 

FROTECT 





Comments 


FRITECT is available only when the HP 82400A Card Reader is installed in your HP-71. When you 
execute FROTECT, the computer prompts you for a card and then allows you to pull the card 
through the card reader once. This operation, which places a write-protect code on the track accessed 
by the card reader, protects that track from being overwritten by a subsequent (CF operation. To 
protect the card’s other track, turn the card around, reexecute FE GTECT, and again pull the card 
through the card reader. 


When a track has been protected, you cannot write over it unless you first execute an LIHFRGTEC? 
operation for that track. 


Related Keywords 


UAPROTECT, 
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PURGE 


GE deletes a file (or files) from RAM. 





mM Statement @ Keyboard Execution 
O Function CO CALC Mode 
O Operator @ iIF...THEN...ELSE 


i file val 
specifier 
2 










Examples 
FURGE "“TESTFILE: FORT" FURIE ALL 
FURGE EEYS FURGE STRESS? 
FURGE "To" FuURGE 


Input Parameters 


ee 
file specifier String expression or unquoted string. File name with optional device 
Default: Current file. specifier. 


Comments 





After you purge a file, you cannot access the information it contained. If you purge the current file, 
work +il¢ becomes the current file. 
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PURGE (continued) 


Purging the current file during program execution: 
1. Halts the program. 

. Clears the program from memory. 

. Releases local environments. 


. Clears all internally-maintained program control information. 


ao f&§ WwW PD 


. Designates work file as the current file. 


Attempting to purge the current file when (1) the workfile 
enough memory to create the workfile results in the Ins: 
condition. 






does not exist, and (2) there is not 
Afficient Memory (error 24) 





Executing FLRGE ALL clears all unsecured files from main RAM. Executing Fl 
purges the system i eu file. 





Related Keywords 


SECURE, UNSECURE. 
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PUT 


FLiT enters a key code (specified by the key’s string argument) into the key buffer. 


@ Statement M Keyboard Execution 


Ol Function O CALC Mode 
Ol Operator @ iF...THEN...ELSE 


Examples 





FUT AE PUT "Fi" PUT "dd e 


Input Parameters 


es 
String Expression. Less than five characters. 


Comments 









This statement adds the specified key to the end of the list of keys currently held in the buffer. (The 
buffer can hold up to 15 keys.) 


The key name is specified in the same format as that for [EF #E‘’. If the buffer is full, executing 
FUT leaves the buffer unchanged. 


Related Keywords 


DEF EEY, REY. 
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PWIDTH 


FLIEITH (print width) defines the line length of FE IHT statements. 


@ Statement M@ Keyboard Execution 


O Function O CALC Mode 
O Operator @ IF...THEN...ELSE 





Examples 


FATOTH IHF PAMIGTH £8 


Input Parameters 


ee 


print width Numeric expression rounded to an 
integer. 


Fill OTH interprets a value less 
than 1 as 1, and a value greater 
than 255 as infinity. 













Comments 


FM IOTH specifies a line width that is used during execution of subsequent FRIHT statements to 
determine the output format. 


Using THE in FR INT statements reduces the THE argument modulo the FiILITH argument. 


Related Keywords 


PLIST, FRIHT, WIOTH. 
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RAD 


: (degrees to radians conversion) converts arguments expressed in degrees to radians. 








O Statement M Keyboard Execution 
@ Function MB CALC Mode 
' © Operator M@ IF...THEN...ELSE 





Examples 








Input Parameters 







Item Description Restrictions 














argument 


Comments 


The conversion constant is accurate to 15 digits, which often produces more accurate results than a 
conversion that does not use FAL. 


Related Keywords 


DEG, DEGREES, RADIANS. 
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RADIANS 


FACTAHS selects Radians mode, which specifies radians as the unit of measure for expressing angles. 








It is a short form of the GFT iS statement. 








M Statement @ Keyboard Execution 
O Function [1 CALC Mode 
Ol Operator @ IF...THEN...ELSE 


Examples 





RAOQTAHS IF A=i THEN RAODQTANS 


Comments 
FAG IAHS turns on the RAD annunciator. 
After executing RADIANS: 
e Any function that returns an angle does so in radian units. 


¢ Instructions that use angles for parameters will interpret such parameters in radian units. 


Related Keywords 


DEGREES, OPTION. 
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RANDOMIZE 


function. 





=E specifies a seed for the 


Statement @ = Keyboard Execution 
Function CALC Mode 
Operator @ IF...THEN...ELSE 


RANDOMIZE 












Examples 


RAHOOMIZE 





Input Parameters 


ee 
Numeric expression. 
Default: Current value in clock register. 


Comments 






The random number series generated by executions of the FHL! function depends upon the starting 
seed value you specify with FAHOOMIZE. If you specify 0 for a seed, the subsequent FHC! sequence will 
consist of all zeroes. Otherwise, FAHOOMI=ZE uses the given seed’s absolute value or the contents of a 
clock register. RAHCGMIZE is a global declaration. That is, executing FAHOGMIZE in a subprogram 
affects the subsequent FH. series in the calling program. 


Related Keywords 


RHO, 
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READ READ (continued) 


REFC assigns values from [iA 7 statements to variables. Comments 











@ Statement @ Keyboard Execution The numeric items stored in | statements are read into the numeric variables ina READ 

O Function C1 CALC Mode ment. If they are not in the correct form (that is, if they are not valid numeric expressions) then an 

CO Operator @ IF... THEN... ELSE error results. A string variable may read what appears to be a numeric item, as long as it is 
eee ase dimensioned large enough to contain the characters.When the current program context changes due to 


execution of FUH FLL, the DATA pointer is reset. The first F statement in a program 
@ accesses the first item in the first DATA E to 
specifier 
name 











statement in that program unless you used Fi! 





specify a different : statement as the starting point. Successive [} operations access 
successive rf items, progressing sequentially through the [/TF statements as necessary. Trying 
to read past the end of the last [ statement causes an error. The F statement may be 
used to alter the order in which F : accesses 4 statements. 












Avalid {7 expression may contain any function calls or variable references that are allowed in any 
other expression. This feature may be useful for reading computed constants or special characters that 
are normally unavailable from the keyboard, such as CATA SGR¢2#PI> and CHRECE??. 


Related Keywords 


Examples 





READ ALB. ko AG READ 280 2,37,0 RERD Ac. 2, Bed 


Input Parameters 








Item Description Restrictions 








variable specifier Numeric variable specifier or string None. 
variable specifier. 


array name Name of a numeric or string array. The number of dimensions must 
Indicates that the entire array is to be read. | match the empty subscripts that 
follow, if specified. 
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READ # 


REA # reads data items from a data file associated with a specified channel number. 








@ Statement 
O Function 


HM Keyboard Execution 
[1 CALC Mode 


| O Operator @ IF...THEN...ELSE 





















channel 
number 






L a 
number 


Examples 


specifier 





name 


REAG #2;0,R,08,F eo, S18¢ 3 REAC #H; Se, 3 


REAG #7, 28; 1,000.8 


Input Parameters 








Item | Description 


Restrictions 





channel number Numeric expression rounded to an 


integer. 


record number Numeric expression rounded to an 


0. 


specifier. 


array name Name of a numeric or string array. 
Indicates that the entire array is to be 


read. 











integer. The first record of the file is record 


| 1 through 255. 


0 through 1,048,575. 


variable specifier Numeric variable specifier or string variable | None. 


The number of dimensions must 


| match the empty subscripts that 


L follow, if specified. 
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R EAD # (continued) 


Comments 


FEA # reads data items from the file assigned to the specified channel number. The file’s type can 
be DATA, TEXT, or SDATA. The data type of each item in the FERAL # read list must match the 
type of corresponding data item in the data file. 


If you specify a record number, the file is positioned to that record and the data items are read. This is 
termed random access. For a file of type DATA or SDATA, specifying a record number greater than 
the number of records in the file causes an Erici of File (error 54) condition. 


If you do not specify a record number, the computer begins reading data items from the data pointer’s 
current position in the file. This is termed sequential access. 


TEXT Files. Every record is assumed to contain a single data item represented as a string of char- 
acters. If a data item is to be read into a numeric variable, the computer attempts to evaluate the 
ASCII string as a numeric expression in a manner similar to that of the 'Ail. function. If the specified 
record number is greater than the number of records in the file, the file pointer is set to the end of the 
file. 


DATA Files. For random access, the number of items in the read list must not exceed the number of 
data items in the record. 


SDATA Files. Each record of this file type can contain a single numeric or string data item. Note 
that strings are limited to six characters. 


If the data type of each item in the READ # read list does not match the type of corresponding data 
item in the data file, the error EFF : Oats Tupe occurs, and the file pointer is adjusted as follows: 


File Type File Pointer Action 


Left at record where error occurred. 










incremented to next record. 


Incremented to next record. 


Related Keywords 


ASSIGH #, ASSIGH, CREATE, PRIN? #, EESTORE #, 
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REAL REAL (continued) 


Ee esl Cain anerbory  Forteah yaniablcsiand alsaye: If FEAL specifies a simple numeric variable that already exists, the variable is reintialized to zero. 
Array variables are redimensioned, but not reinitialized to zero (unless the data type is changed). If 
FEAL expands an array, it also initializes all newly-created elements in the array. Notice that 





M@ Statement M@ Keyboard Execution . ‘ ma igees 
M Function O CALC Mode redimensioning does not necessarily preserve an element’s position within an array, but does preserve 
QO Operator @ sIF...THEN...ELSE the sequence of elements within an array. (Refer to “Declaring Arrays (OIM, REAL, SHORT, 








INTEGER)” in section 3 of your HP-71 Owner’s Manual.) 


The following table indicates the conditions that apply to FEAL variables and arrays: 
REAL Numeric Variables 


variable 
limit 4 
limit 2 
Maximum No. of Array Dimensions 2 


Examples Maximum Dimension Limit 65535 


Memory Usage in Bytes 
¢ Simple Variable 9.5 
° Array 8*«(dim1—base+1)*(dim2 — base + 1) + 9.5 





Initiat Value 0 
Numeric Precision 12 Decimal Digits 


Exponent Range +499 






REAL REAL Gacy, 23 RERL H, Pod, 43 





Input Parameters 








Item 






Description Restrictions Related Keywords 


















numeric variable fT, DESTROY. 
dimension limit 1 } 


dimension limit 2 


Letter followed by an optional digit. None. CIM, TIHTEGER, GPTION BASE, 5 










Numeric expression rounded to an integer. | Current CF TIOH EASE setting 
through 65535. 











Comments 


REAL creates real variables and arrays. Creation occurs upon execution of FEFIL. The dimension 
limits are evaluated at creation time. The lowest-numbered subscript in any dimension is 0 or 1, 
depending on the GF TIGH EASE setting when the array is created. All elements are initialized to 
zero. 
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RED 


REC x,y (reduction) returns a remainder defined by the expression 


x—-—y*¥n 


where n is the nearest integer to x/y. If x/y lies exactly between two integers, FEL: uses the even 
integer. 





O Statement M Keyboard Execution 
@ Function M@ CALC Mode 
O Operator @ iF... THEN...ELSE 
D)—+O O o 
Examples 
A=REDCH, S683 IF REQ¢K, 23=1 THEW FRINT 


Input Parameters 


argumentt 7 » i 
9 Numeric expression. Refer to “Comments,” on the facing 


argument2 page. 
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R ED (continued) 


Comments 


FED is the remainder function defined by the IEEE Floating Point Standard.* FEO has the following 
properties: 


e FED ‘x,y is periodic in x with period ly|, except at odd multiples of y/2, where the period 
is 2lyl. 
e FEC “x,y? lies in the interval [—| y!/2, | y|/2]. 





generates exact answers (that is, no rounding is necessary for the 12-digit result). 
FEC is useful for angle reductions, since 
—180 <= FED (x,360) <= 180 


and the result is exact. For example, REL ~1! 





—1E—20, exactly. 





If argument is Ir or argument2 is equal to zero, the Imvslid Ara (error 11) condition results. 


Related Keywords 
MOO, RMD. 


*The remainder function is referred to as REM in the IEEE Floating Point Standard. 
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REM 





| (remarks) enables you to document your programs with comments. 





@ Statement @ = Keyboard Execution 
[ Function O CALC Mode 
[ Operator M@ IF...THEN...ELSE 














Input Parameters 








Item | Description Restrictions 








character Any character. None. 














Comments 





When program execution encounters it assumes that any remaining information in that line 
consists of remarks, and not executable keywords. Thus, in the following example, the & 
is ignored: 





10 IF B$=C$ THEN PURGE B$ @ REM PURGED B$ @ DISP C$ 


When you want to enter a comment in a program line without using the @ FEM... construction, use 
the | exclamation point. (Wherever FEM is allowed, | is also allowed. Notice, however, that | does not 
require use of the @ character.) 
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RENAME 


FEHAME changes the name of a file. 





™@ Statement @ Keyboard Execution 
O Function [1 CALC Mode 
' © Operator @ IF...THEN...ELSE 









file 
fil 
Peseta KEYS 
KEYS 








Examples 
RENAME TESTE REHAMNE KEYFR2 TO KEYS 
REHANE REHAME AS TO BS 
REMAMNE 





Input Parameters 


Description 





file specifier String expression or unquoted string. File name with optional device 
Default: Current file. specifier. Proposed file name must 
not already exist on the device 
containing the designated file. 





Comments 


You can use FEHAME TO file name to name the « 
file. 


file is the current 





fide when the tu: 











REMAME KEYS TO 
key assignments. FE 





file name renames the current key assignment file, which deactivates any active 
ANE filename Ta & = designates the specified KEY file to become the 





current key assignment file. If the specified file is not in main RAM, an error occurs. 
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R ENAME (continued) 


A device specifier for the file you rename may be given in either file specifier (that is, before or after 
the T). If both file specifiers include device specifiers, then the device in the first file specifier 
(whether implicit or explicit) is always interpreted as the device containing the file to be renamed. In 
such cases the second device specifier is ignored. An example of an implicit device specifier is: 


REHAME TO As PORT 


The preceding example implicitly specifies the device containing the current file. Thus, FEHAME 
ignores the : FUE 7 device specifier. 
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RENUMBER 


FEHUMEER renumbers the lines in a program file. 







@ Statement HM Keyboard Execution 
O Function O CALC Mode 
Ol Operator @ IF...THEN...ELSE 


RENUMBER 
i new start t = increment ns oo old start ; old final 
value line number line number 


line number 


Examples 





Input Parameters 


Integer constant. 
Default: 10. 


Integer constant. 
Default: 10. 


















Item Restrictions 





| new start line 
‘ number 


1 through 9999. 









increment value 1 through 9999. 





















: old start line Integer constant. 1 through 9999. 
| number Default: Start of file. 

| old final line Integer constant. 1 through 9999. 
| 

| 


number Default: End of file. 
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RENU MBER (continued) 


Comments 


RENUMEER operations are subject to the following: 
e If the HP-71 cannot find the old start line number, it locates the next successive line number and 
begins renumbering from that line. 


e If, during renumbering, FEHLINEER reaches line 9999 before the entire program is renumbered, 
the computer automatically renumbers the program lines using 1 for the increment between lines. 
In this case, if the new start line number was not specified, it defaults to 1. 


e If a renumbered line is referenced by a program statement such as GOTO or GOSUE, the com- 
puter automatically changes that reference to reflect the new line number. 






Note: Where FUH, LIST, or FE 
numbers, any execution of FEHLIM 
the new line numberings. 


EER are program statements referring to specific line 
EF does not adjust those references to correspond to 
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RES 


FES (result) returns the value of the most recently executed numeric expression. 






O Statement M@ Keyboard Execution 
M@ Function M@ CALC Mode 
[1 Operator @ IF...THEN...ELSE 





RES 


Examples 





em 
iT} 
tre 
i 

+ 


STHCRES 2 
IF FES >.5 THEN DISP M4 


Comments 


The HP-71 stores the result of each numeric assignment and calculator statement in a register re- 
served for use by FE. This occurs prior to any rounding that may take place due to a SHORT or 
INTEGER destination variable. FE % recalls the value currently stored in this register. FES can be 
particularly useful in iterative computations because it is much faster than variable references. 





In CALC Mode, the computer implicitly executes FE = 
Thus, =!H« 3 returns the sine of the previous result, and MF 
vious result and variable Fi. 


© whenever a null subexpression is completed. 
i» returns the larger of the pre- 
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RESET, RESET CLOCK 


executing EXART. 


M Statement B® Keyboard Execution 
O Function Ol CALC Mode 





O Operator @ IF...THEN...ELSE 






Examples 


RESET RESET ti 





Comments 


The RESET Statement. RESET clears all user flags (0 through 63) and the system flags that can be 


set or cleared by users (flags —1 through — 32). Reset also sets all math traps to their DEFALILT OH 
settings. 


The RESET CLOCK Statement. RESET CLOCK clears the Exact flag (flag —46) and the sys- 
tem clock’s adjustment factor. 


Related Keywords 
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RESTORE 


RESTORE specifies which [ATA statement will be used by the next READ operation. 









M Statement M Keyboard Execution 
O Function O CALC Mode 
Ol Operator @ IF...THEN...ELSE 





SEY 


identifier 


Examples 





RESTORE RESTORE Lae RESTORE ARRAYS 


Any valid line number or label 
reference. 


Input Parameters 














statement 
identifier 


Line number or label of a program 

statement. 
Default: First © 

program. 












Fi statement in the 








Comments 





If FORE specifies a line that does not contain a 
[IATA statement following the specified line. FE= 
program. If no line number is specified, the next F: 
the current program or subprogram. 







CATA statement, the computer uses the first 
RE can only refer to lines within the current 
statement in 





statement uses the first ['F 


Related Keywords 
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RESTORE # 


RESTORE # sets the file pointer associated with the specified channel number to the indicated 
record number. 











@ Statement M Keyboard Execution 
O Function OO CALC Mode 
Ol Operator @ IF...THEN...ELSE 


RESTORE # 
©) 










channel 
number 





Examples 





Input Parameters 


Numeric expression rounded to an 
integer. 


1 through 255. 



















channel number 









record number Numeric expression rounded to an 
integer. The first record of the file is record 


0. 


O thru 1,048,575. 







Default: Beginning of the file. 








Comments 


For a file of type DATA or pony eens a record number greater than the number of records in 
the file results in an © ile (error 54) condition. For a TEXT file, if the record number 
does not exist, # dete 3 the file pointer to the end of the file, which causes the next record 
written to the file to be appended to the current end of the file. 









Related Keywords 
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RETURN 


EETUEH returns program execution to the statement following the invoking GOSUE. 






. Statement BW Keyboard Execution 

O Function [1 CALC Mode 

C) Operator B@ IF...THEN...ELSE 
Examples 


Program Segment: 


i: 


In the above example, the © & on line 310 transfers execution to the subroutine beginning at line 
700. The RE 4 at line 720 terminates subroutine execution and transfers program execution to 


line 320. 


Comments 








Related Keywords 
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RMD RMD (continued) 





Related Keywords 


FMEI<x,y% (remainder) returns the remainder defined by the expression x — y « IF (x/y). 


OV, MOO, REG. 








C] Statement M Keyboard Execution 
BH Function mM CALC Mode 
O Operator @ IF...THEN...ELSE 
0) © 6) 
Examples 





Input Parameters 


ee 


argument1 } 
argument2 | 


Refer to Comments, below. 













Numeric expression. 





Comments 


FMC! is the remainder function defined by the ANSI BASIC Standard,* and has the following 
properties: 


X,y* is not periodic in x across x = 0. 





x,y? lies in the interval 
e (0, yl) for x >= 0. 
e (—ly|0] for x <= 0. 
e For xy > 0, FMOex,ys = MODex ys. 
¢ Returns results that are exact. (Mi never sets the INX flag. No rounding needs to be done 
because the result is never greater than 12 digits.) 





If either argument1 equals Ir or argument 2 equals zero, the Irwsslicd Arg (error 11) condition 
results. 


* The remainder function is referred to as REM in the ANSI BASIC Standard. 
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RND 


FHC (random number) returns the next real number in a pseudo-random number sequence and up- 
dates the random number seed. 





O Statement @ Keyboard Execution 

@ Function ™@ CALC Mode 

(1 Operator B® IF...THEN...ELSE 
Examples 


Re CRAC +R HO oS F 





Comments 


The HP-71 uses a linear congruential method and a seed value to generate a random number value (r), 
which always lies in the range 0 <= r < 1. Each succeeding execution of FHI returns an r-value 
computed from a seed based upon the previous Fifi value. 


Note: If the seed is zero, the Fiil sequence will likewise be zero. 





You can change the seed by executing FANDGMIZE. 





Related Keywords 





RAH 
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RUN 


FLiH executes a BASIC or binary program. 








Mm Statement @ Keyboard Execution 
Ol Function (1 CALC Mode 
(1 Operator @ iF...THEN...ELSE 









loaner | 
file 
specifier 






statement 
identifier 








Examples 
FeLi h FLT 
RUN CARD RUM FROG 
RUM . STARTS RUM i CARD, 36 





BUR LE 





Input Parameters 


Item Description 

















file specifier String expression or unquoted string. File name with optional device 
Default: Current file. specifier or i 

line number Integer constant. 1 to 9999. 

statement Line number or label of a program Any valid line number or label 


identifier statement. reference. 
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RUN (continued) 


Comments 


If an external device contains the specified file, it is first copied into main RAM, then executed. When 
you enter a file specifier and execute F'lLiH, that file becomes the current file. 


If you enter a line number or label reference after a file specifier, Fiiti begins program execution at 
that line or statement. Otherwise, =H begins execution at the first statement of the program. If the 
computer does not find the specified line number, but does find a higher-numbered line, Fi begins 
execution with that line. If you enter only a line number or label reference (and no file name), FLUH 
begins executing the current program from the specfied statement. 


Note: The label reference must be preceded by a comma to distinguish it from a file specifier. The 
comma preceding the line number is optional. 


Effect of RUN on Suspended or Running Programs. Executing Fii}i from within a running 
program causes the computer to halt the current program, switch to the specified program (which 
becomes the “current file”), and run the new program. 


If you suspend a program (which turns on the SUSP annunciator), subsequently executing FH turns 
off the SUSP annunciator, closes all files, releases local environments, clears all program control in- 
formation with respect to the suspended program, and executes the specified program, as described 
above. 


The Key. This key is a direct execute key. It causes program execution to begin with the first 
statement of the current program. 


The Effect of RUN on Current Memory Status. FiiH closes all files, releases local environ- 
ments and clears all program control information associated with a prior suspended program. (This is 
equivalent to EH.) 


Related Keywords 
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SCl 


SCI (scientific format) sets the scientific display format (SCI mode) and the number of significant 
digits to be displayed (or printed). 










: Statement M Keyboard Execution 
O Function 1 CALC Mode 
Ol Operator @ IF...THEN...ELSE 





- number 
(scr ) 
Examples 
SCT 0 TF i it 





Input Parameters 


number of digits Numeric expression rounded to an 0 through 11. =" 1 interprets a 





integer. value less than 0 as 0, and a value 
greater than 11 as 11. 


Comments 


Display format statements control the format setting for displaying numbers. The display setting 
remains in effect until you execute another =f, Fix, EMG, STE statement. 





specified number of digits. The value appears as 


= 1 display format displays values in scientific notation to d + 1 significant digits, where d is the 


(Sign) Mantissa E (Sign) Exponent 


where, for normalized numbers, 


1 <= Mantissa < 10 


and, for denormalized numbers, 
Mantissa < 1. 
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SCI (continued) 


Related Keywords 


EMG, Fle, STO, STE. 
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SDEV 


SCE (standard deviation) returns the sample standard deviation for the specified variable in the 
current statistical array. 


O Statement M Keyboard Execution 
@ Function M@ CALC Mode 
1 Operator @ iF...THEN...ELSE 








number 


Examples 





Input Parameters 


ie ao 


Zero through the current 27 FT 
array dimension. 










variable number Numeric expression rounded to an 
integer. 


Default: 1. 












Comments 


The sample standard deviation calculation uses n — 1 as the denominator, where n is the sample size. 
For information concerning statistical arrays, refer to the “Mathematical Discussion of HP-71 Statis- 
tical Arrays,” page 334. 


Related Keywords 
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SECURE 





C1) Function 
| C1 Operator 


M@ Statement 






z file | 
iS specifier wl 
KEYS 





Examples 





Input Parameters 


M Keyboard Execution 
(1 CALC Mode 
@ IF...THEN...ELSE 














= _ — 
Item Description 


Default: Current file. 


Restrictions 


specifier. 


file specifier | String expression or unquoted string. File name with optional device 





Comments 


If a secured file is not. private: 


¢ In a catalog listing the file appears with an = 


¢ The file can be read, listed, and executed. 


in the file protection field. 


¢ The file cannot be altered, purged, or declared private. 


A file that is both secure and private appears in a CAT listing with an E in the file protection field. 
Access to such files is limited to execution only. To remove a file from secure status, refer to the 


UNSECURE keyword entry. 





Related Keywords 


PETUATE, UNSECURE. 


| 
SECURE (continued) | 
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SETDATE 





SETOATE sets the system clock to the specified date. 








@ Statement M Keyboard Execution 
O Function C1 CALC Mode 
Ol Operator @ IF...THEN...ELSE 








SETDATE 





numer ic 
date 
ae 


string 





Examples 





SETOATE OF 


Input Parameters 


Item Description Restrictions 








Numeric expression rounded to an Must be of the form YYDDD or 
integer. YYYYDDD, where YYor YYYY = 
year and DDD = day-in-year. For 
leap year: DDD is in the range of 1 
through 366. For other years, DDD 
is in the range of 1 through 365. 


numeric date 


Must be a valid date of the form 
YY/MM/DD or YYYY/MM/DD. 


date string String expression. 
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SETDATE (continued) 


Comments 


You can specify either a year and the day number of the day in that year, or a date string. The HP-71 
uses either YY or YYYY formats for year inputs, MM for month inputs, and DD for day inputs. 
For numeric date inputs and for date string inputs, if you use the two-digit year format, and if: 

» 60 <= YY <= 99, then YY = YY + 1900. 

e0 <= YY <= 59, then YY = YY + 2000. 
If you use the date string format that specifies a four-digit year, the computer interprets the year as 


entered. Although and = display only the last two digits of the year portion of a date, 
all four year digits are maintained internally. 





Related Keywords 
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SETTIME SETTIME (continued) 





SETTIME sets the time on the system clock. Comments 





Hours (HH) must always be entered as two digits, and in 


m@ Statement ™@ Keyboard Execution the 24-hour clock format shown in the table to the right. 
O Function [1 CALC Mode 
Ol Operator @ if...THEN...ELSE 





12 Midnight 
1 am. 





seconds 
since midnight 


string 





Examples 





SETTINE T# 





Input Parameters 
The HP-71 uses =ETTIME inputs in two ways: 


Description Restrictions 





1. The time you enter is used to set the clock time. 


seconds since Numeric expression rounded to an integer. | 0 <= seconds < 86400. 2. The difference between the time currently maintained by the clock and the time you enter is 

midnight interpreted as two entities, as follows, for interpreting the error correction factor: 

time string String expression. Must be of the form HH:MM:SS 
representing time < 24 hours. 





e The portion of the difference that is a multiple of 30 minutes is interpreted as an absolute 
adjustment, such as that used for a time zone or daylight savings change, and is not used as 
an error correction input. 





e The portion of the difference that is not a multiple of 30 is used to automatically determine 
and store an error correction factor that is applied the next time you execute E . The 
HP-71 measures this portion from the nearest 30-minute increment and applies the appro- 
priate sign. 





For example, if the current HP-71 clock time is 10:03:17 and you execute S£T1 
"18:85: * to correct the clock, the HP-71’s clock is set to 10:05:30 and an error factor is 
computed on the basis of 5" 30° — 3" 17°, or +2™ 13°, and is automatically stored. 
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SETTIME (continued) SFL AG 





The SETTIME error correction factor is cumulative between executions of EXACT. This allows you SELAG (set flag) sets user and/or system flags specified by keyword or by a flag number list. 


to execute =ETTIME as many times as you wish before executing EXACT. 






The resolution of the clock system is 1/512 second. A numeric input for SETTIME can specify frac- @ Statement M Keyboard Execution 
tional seconds; a string input cannot. O Function O CALC Mode 
0 Operator @ iF...THEN...ELSE 


Related Keywords 


AOJAGS, AQWIUST, AF, EXACT, TIME, TIMES. 





Examples 


SFLAG ALL SFLAG MATH SFLAG 1, 10MS8, OVP 


—32 through 63. 


Input Parameters 


Description 
Numeric expression rounded to an 
integer. 


SFLAG sets flags as follows: 
iLL. sets all user flags (0 through 63). 












flag number 






Comments 






TH sets the math exception flags. 





e FLAG with a flag number list sets the system and user flags specified by the integer-rounded 


values of the numeric expressions in the list. =F iG cannot set system flags numbered less than 
32: 


Related Keywords 
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SGN 





SGHts 3 (sign (x)) returns —1 if x is less than zero; 0 if x equals zero; and 1 if x is greater than zero. 
Ol Statement BM Keyboard Execution 
@ Function ™@ CALC Mode 
O Operator @ IF...THEN...ELSE 
)—-O © 
Examples 












Comments 


The table to the right shows the values returned by =GH. 


<0 
= NaN NaN 


Related Keywords 
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SHORT 


SHOET allocates memory for short (5-digit precision) variables and arrays. 







@ Statement M@ Keyboard Execution 
1 Function 1 CALC Mode 
[1 Operator @ iF...THEN...ELSE 


ree eee 
dimension 
dimension 
limit 2 






Examples 
SHORT T SHORT FOF, 33 SHORT HE, Med, 43 


Input Parameters 


Letter followed by optional digit. 












item Restrictions 





numeric variable 








None. 





dimension limit 1 









Current GFT = setting 


through 65535. 


Numeric expression rounded to an 
integer. 









dimension limit 2 


Comments 





=H T creates short variables and arrays. Creation occurs upon execution of 5 ’. The dimension 
limits are evaluated at creation time. The lowest-numbered subscript in any dimension is 0 or 1, 
depending on the OF TI1%H EASE setting when the array is created. All elements are initialized to 


zero. 
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SHORT (continued) 


If SHORT specifies a simple numeric variable that already exists, the variable is reinitialized to zero. 
Array variables are redimensioned, but not reinitialized to zero (unless the data type is changed). If 
SHORT expands an array, it also initializes all newly-created elements in the array. Notice that 
redimensioning does not necessarily preserve an element’s position within an array, but does preserve 
the sequence of elements within an array. (Refer to “Declaring Arrays (DIM, REAL, SHORT, 
IHTEGER)” in section 3 of the HP-71 Owner’s Manual.) 


The following table indicates the conditions that apply to SHOT variables and arrays: 
SHORT Numeric Variables 


Initial Value 0 
Numeric Precision 5 Decimal Digits 
Exponent Range +499 


Maximum No. of Array Dimensions 2 


Maximum Dimension Limit 65535 


Memory Usage in Bytes: 
¢ Simple Variable 9.5 
® Array 4.5*(Dim1 — Base+1)*(Dim2 — Base + 1) + 9.5 


Related Keywords 
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SHOW PORT 


SHOW FORT displays the type and size, in bytes, of all memory devices in your HP-71. SHO 
FORT is nonprogrammable. 






@ Statement M Keyboard Execution 
QO Function 1 CALC Mode 
[11 Operator @ IF...THEN...ELSE 


a= 
© 


Examples 





SALE Fhe T SHO Ld 


Comments 


For each memory device =Hf@li FORT displays the port number, the device size in bytes, and the 
device type number. Memory type numbers range from 0 through 15: 


Device Type Device Type Number 


Main RAM 
Independent RAM 
ROM 
EEPROM 







Refer to FEEE FET for port numbering information. 


As an example, after FREE PORT*.&2>, the SHOM FORT statement would display for that mem- 
ory device: 


.Be 4636 1 


b 


This indicates that port 0.02 contains 4096 bytes of independent RAM. 


Le 
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SIN 


SIH (sine) returns the sine of its argument. 


Ol Statement @ Keyboard Execution 


@ Function WM CALC Mode 
O Operator @ IF...THEN...ELSE 


Gi} + Oe} +O 


Examples 





WeRESTM¢ Ta 


Input Parameters 


Tne [non |e 


Comments 











1H first reduces the argument modulo 360 (when in Degrees setting) or modulo 2«7 (when in Radians 
setting). 51H assumes that the argument is expressed according to the current angular setting. In 
Radians setting, SIH uses a 31-digit representation of 7 to increase accuracy. Also: 


e SING +> = +0 
e STH 1s & na = [(—1)"] « 0; where n = 1,2,3,... (Degrees mode). 


e SIH -xs = —SIN¢x:; for example, SIH¢-158> = +0. 


Related Keywords 
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SQR (SQRT) 


=m (square root) returns the square root of the argument. 








o Statement @ Keyboard Execution 
M@ Function M@ CALC Mode 
C1 Operator M@ IF...THEN...ELSE 







argument 


Examples 





T=SQR CEES 6G 2 FR THT 


Input Parameters 
















The argument must be greater than 












argument Numeric expression. 
; or equal to zero. Refer also to 
“Comments,” below. 
Comments 





If the argument is less than zero, then the : 


Note: Because —0 is non-negative (-~O0=0), SQR(—0)= —0. 
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STARTUP 


STARTUP defines a command string to be executed when you turn on the HP-71. 








@ Statement M@ Keyboard Execution 
O Function 1 CALC Mode 
O Operator @ IF...THEN...ELSE 
Examples 
STARTUP 
"RUB MOR TTOR" 
STARTUP "WIGTH INF @ DELAY .5, INF" 


Input Parameters 


[ee [in 


Comments 





0 through 95 characters. 








When specifying a STARTUF string, you can use any string of instructions that you can otherwise 
execute from the keyboard. To enter a multistatement string, use @ to concatenate the statements in 
the same way that you would when executing multistatement commands from the keyboard or in a 
program. 





STARTUP Operation. When you execute STARE TUF, the HP-71 stores the ee command 
string as it is typed, without checking for syntax errors. The computer maintains only one STAR TUF 
Bring at any given time. When you switch the computer off, then on, if the string is error- ifiee. the 
bs IF string is executed. Otherwise, the computer displays an error message. If the computer is 
in ‘CALC mode when you turn it off, or if EYE FF turns off the computer during program 
execution, the =TARTUF string is not executed when you turn the computer on again. 


















Clearing a STARTUP String. Once you specify a =THETUF string, it remains active until 


cleared. To clear a = ‘LIF string, execute =7AET with a null string (STAR TUF**), 
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STAT 


=THT (statistics) either creates and dimensions a statistical array to the appropriate size for a speci- 
fied number of variables, or designates a previously dimensioned statistical array as the current statis- 
tical array. 









a Statement ™@ = Keyboard Execution 
O Function [1 CALC Mode 
O Operator @ IF...THEN...ELSE 





8 -— number ae : 
of variables 


Examples 


STAT Atds STAT & 


Input Parameters 








None. 












array name Numeric variable. 
number of Numeric expression rounded to an 0 through 15. 
variables integer. 






Comments 





47 allows you to simultaneously store several statistical arrays and to analyze them in any order. 





Before performing statistical calculations, you must specify both the array to use for accumulating 
summary statistics and, if the array did not already exist, the number of statistical variables (coordi- 
nates) for each data point. 


Creating an Array. 277 specifies the current statistical array and the number of variables per 
data point. You can specify the number of variables as any numeric expression whose rounded value is 
in the range of 0—15. 





The HP-71 uses eine numer of variables to automatically allocate enough space for the array. The 





setting of zero, regardless of the current OF TIOH 
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STAT (continued) STD 


Selecting an Existing Array. In an existing statistical array the number of variables is already set. =TO (standard) selects the HP-71’s standard BASIC format for displaying numbers. 
Thus, you need not specify the number of variables when using STAT to select an existing statistical 
array. 







m@ Statement ® Keyboard Execution 
Related Keywords . O Function CO CALC Mode 
O1 Operator @ IF...THEN...ELSE 


AOD, CLSTAT, CORR, OROF, LE, MEA, PREGW, SOEWV, TOTAL. 


STD 


Examples 


TO IF FLAGCOe=i THEN S70 


an 


Comments 
The =TL format conforms to ANSI Mimimal BASIC Standard X3J2, and produces the following 
results when displaying or printing a number: 


e Numbers that can be represented exactly as integers with 12 or fewer digits are displayed without 
a decimal point or exponent. 


e Numbers that can be represented exactly with 12 or fewer digits, but not as integers, are displayed 
with a decimal point but no exponent. Leading zeroes to the left of the decimal point and trailing 
zeroes in the fractional part are omitted. 


e Zero is displayed as &. 


e All other numbers are displayed in the following format: 


(Sign) Mantissa E (Sign) Exponent 


where the value of the mantissa is in the range 1 <= x < 10, and the exponent is represented by 
one to three digits. (A denormalized number has a mantissa that is less than 1 and an exponent of 
—499.) Trailing zeroes in the mantissa and leading zeroes in the exponent are omitted. 
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STD (continued) 


The following table provides examples of numbers displayed in =Tf format: 


: Representable 
sunber Displayed AS | with 12 Digits? 


100000000000 Yes-integer. 
1.E12 No. 


.000000000001 
-.000000000012 
1.23E—11 
12.345 





Any display setting remains in effect until changed by another Fi®, SCI, EH&, or STO statement. 


Related Keywords 


EHG, Fla, SCl, STRE#, 
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STOP 


STF operates in the same was as EHD to end a subprogram, user-defined function, or a program. 





m@ Statement @ = Keyboard Execution 

O Function 1 CALC Mode 

[1 Operator @ iF...THEN...ELSE 
Examples 

STOP IF #<8 THEH STOP 
Comments 
A program can contain more than one =7(F statement. 


Executing =7CF from the keyboard releases a suspended program. 


Related Keywords 





j PAUSE. 
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STR$ 


STR# (numeric-to-string conversion) returns a string representation of the value of the argument. 


C] Statement 


@ Keyboard Execution 





@ Function O CALC Mode 
[| Operator @ IF...THEN...ELSE 
© © 
Examples 
ASS TRECH 3 QiSP "sS="1STRE 


Input Parameters 


Comments 






The returned string is in the current display (or print) format, except that a positive value represented 
as a string is shifted one space to the left. =T&# formats infinity as Ir, and NaN as Hal. 


Standard (STD) Display Format. The STD format conforms to ANSI Minimal BASIC Standard 
X3J2, and is enabled by executing STC. (Refer to the STD keyword entry.) 


Fixed-Precision (FIX) Display Format. The value is displayed rounded to n places past the 
decimal point, where n is specified by F i n. Where the number of digits displayed by this method 
would exceed 12, the value is displayed in ="1 n format. Where the nonzero value rounded to n 


places past the decimal point would be zero, the value is displayed in 31 n format. 
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STR$ (continued) 


Scientific (SCI) Display Format. The value is displayed in scientific notation to n + 1 significant 
digits, where n is specified by =( 1 n. The value appears as: 


(Sign) Mantissa E (Sign) Exponent 


where 1 <= mantissa < 10 for normalized numbers, and the mantissa is less than 1 for denormalized 
numbers. 


Engineering (ENG) Display Format. The value is displayed to n + 1 significant digits, where n 
is specified by Eli n. The value appears as: 


(Sign) Mantissa E (Sign) Exponent 


where 1 <= mantissa < 1000, and the exponent is divisible by 3. If the value has an exponent of 
—499, it is displayed in 521 n format. 


Related Keywords 


PF, EMG, File, PRINT, SCI, STO. 





rit 
Pb 
Li 
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SUB 


LIB (begin subprogram) is the first statement in a subprogram and can specify the subprogram’s for- 


mal parameters. 


® Statement O Keyboard Execution 


O Function OO CALC Mode 
CO Operator O IF...THEN... ELSE 


subprogram 
name 









a 


parameter 


Examples 


SUB FLOTO#, ¥, 0032 SUE ACH, BS, #23 SUE PAYROLL 


Input Parameters 


a 


Unquoted string consisting of letters and Up to eight characters. 
digits, and starting with a letter. 









subprogram name 














Channel number must be integer 
constant in the range 1 to 255. 


formal parameter Simple or array variable name, or channel 


number preceded by #. 


Comments 


SLE identifies the start of a subprogram. An EHODSUE, another SUE statement, or the end of the 
program file terminates the subprogram and returns program execution to the statement following the 


CALL statement that invoked the subprogram. 





Parameter Passing. Actual parameters (those in the “fii.i. parameter list) and formal parameters 





(those in the =. parameter list) must match in type and number. Parameters can be passed to a 
subprogram by value or by reference. The distinction is specified in the [AL statement. Array 
variables passed by reference must be specified by the variable name, followed by an empty set of 
parentheses to specify the number of dimensions. (For example, a two-dimensional array, =, appears 
as Fil. 3). 
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SUB (continued) 


All variables used in the subprogram, except those passed as parameters, are local to the subprogram. 
If a subprogram takes no parameters, then the channel numbers it uses are those of the calling pro- 
gram. Any channel number specified in the formal parameter list must be a constant. 


Subprograms in Files. A BASIC program file can contain more than one subprogram. Also, a 
subprogram can reside in the same file as a main program. 


If a subprogram is in the same file as the main program it must follow the main program. If there is 
more than one subprogram in a file, the subprograms must be placed consecutively. Any statement 
placed between two subprograms is ignored during program execution. 


Binary Subprograms. You can write a subprogram in BASIC or in assembly code. ALL can in- 
voke either subprogram type. 


How the HP-71 Searches for Subprograms. If no file specifier is given in the CALL statement, 
the subprogram search begins with the current file. If the subprogram is not found, the search contin- 
ues through the files in main RAM, then through the files on plug-in memory devices and independent 
RAMs. If the subprogram is not found in any file, and if the CALL statement lists no parameters, the 
HP-71 then begins searching for a Program having the specified name. 


Related Keywords 


CALL, EHO SUE. 
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TAN 





(tangent) returns the tangent of its argument. 





| CO Statement M Keyboard Execution 
@ Function M CALC Mode 
Ol Operator M@ IF...THEN...ELSE 





Examples 





Input Parameters 









| Item | Description ii Restrictions 


argument Numeric expression. 


Comments 








Must be finite value. 


TAN first reduces the argument modulo 360 (when in Degrees setting) or modulo 2* x (when in 
Radians setting). TAH assumes that the argument is expressed according to the current angular set- 
ting. In Radians setting, THM uses a 31-digit representation of « for increased accuracy. 
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TIME 


TINE returns the time of day expressed in seconds since midnight (00° 00™ 00°). 








Oo Statement ™@ Keyboard Execution 

B Function ™@ CALC Mode 

[1 Operator @ iF...THEN...ELSE 
Examples 





A=TIME 


Related Keywords 


TIMES. 


Comments 


Returns time since midnight to the closest 100th of a second. (This assumes the clock has been 
set correctly using the SE TT INE command.) 
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TIMES 


TIME (time string) returns the time of day as a string in the format HH:MM:SS. 


O Statement Keyboard Execution 


® Function CALC Mode 
O_ Operator IF... THEN...ELSE 


Examples 





Aig=TIMES DISP TIMES 


Comments 


The TIME function uses the 24-hour format shown in 
the table to the right. 


12 Midnight 
1 am. 


12 Noon 
1 p.m. 


Related Keywords 


TIME, 





00 
01 
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TOTAL 


TOTAL returns the total of the specified variable in the current statistical array. 











O Statement WM Keyboard Execution 
@ Function @ CALC Mode 
O Operator @ IF...THEN.. 


ee 
(O—*"hanber® FQ) 







. ELSE 








Examples 


Ai = TOTALCHIS 





Input Parameters 


Numeric expression rounded to an Zero through current STAT array 
integer. dimension. 
Default: 1. 





variable number 












Comments 





Because variable “0” of a statistics array accumulates the number of coordinate inputs, executing 
TOTAL ¢&2 returns the number of data points currently summarized in an array. 


Related Keywords 
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TRACE FLOW/VARS/OFF 


TEACE FLOM reports changes in the flow of a running program. TEACE \AFS reports all variable 
assignments in a running program. TEACE OFF turns off all TRACE operations. 





@ Statement M@ Keyboard Execution 
O Function O CALC Mode 
O Operator @ iF...THEN...ELSE 





Examples 


MY 
a 


cr 


Fry 





TRACE FLOW TR TRACE OFF 


Comments 


TRACE FLOW traces program execution during branches from the current statement, as when GOTO 


or GOSUEB is executed. 





traces the changes in the values of all program variables. 





*: does not trace the effects of CESTREO' and variable redimensioning. 


is eat 


F turns off any active TRACE operations. 





Trace operates globally. Thus, if a subprogram sets Trace mode, but does not subsequently clear it, the 
mode remains active when execution returns to the calling program. 


iJ can be active at the same time. 


TRACE WARES and TEACE FL 
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TRANSFORM 


TEAHSECEM is used to transform BASIC program files into TEXT files for interchange purposes, or 
to transform them back into BASIC program format. 









m@ Statement M Keyboard Execution 
O Function O CALC Mode 
(1 Operator @ IF...THEN...ELSE 









TRANSFORM 
source destination 








Examples 
LIFIPRO It FRO 
A¢ INTO BASIC 
IHTO TEXT 





TRAHSFORM “INTO" ITHTO TEST 


Input Parameters 

















source file File specifier of file from which lines to be String expression or unquoted 
reformatted will be read. string containing a file name with an 
Default: Current file. optional device specifier. 
file type File type specifying format of destination Must be BASIC or TEXT (LIF1). 


file. 











String expression or unquoted 
string containing a file name with an 
optional device specifier. 


File specifier of the file into which lines to 
be reformatted will be written. 
Default: Source file. 


destination file 
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TRANSFORM ccontinued) 


Comments 


The HP-71 TEXT file type can be referred to as LIF1, and is in fact identical to the LIF1 file type 
generated by the HP-75 computer. The HP-71 interprets and decompiles LIF1 as TEXT. For example, 
if you enter 


100 TRANSFORM “AAA” INTO LIF1 
then list this line, the HP-71 displays 


100 TRANSFORM "AAA" INTO TEXT. 


Transformation In-Place. If you omit the destination file, or if it is the same as the source file, the 
source file itself is transformed into the = epectien file type. If the file i is nalrendy of the desired Per no 
action is taken. If the file is the 
is created. The HP-71 allows in- as ‘ecnsforiietion only for files ae in RAM. 





TLL 


Transformation Out-of-Place. If the destination file is not the source file, a transformation des- 
tination file is created (it cannot already exist). If the source file is already of the desired type, a 
simple copy occurs. If the destination file is to be created on an external device, the HP-71 makes a 
preliminary pass through the source file to determine the file size needed for the destination file. The 
computer then creates the destination file and writes the transformed data, line by line, to the des- 
tination file. Any warning messages displayed during the preliminary pass will be displayed again 
when the file is actually transformed. - 


BASIC-To-TEXT Transformations. A BASIC-to-TEXT transformation converts (“decompiles”) 
a BASIC program file into equivalent lines of ASCII text. The starting line number of each statement 
is decompiled as a four-digit nurabee with leading zeroes supplied. A decompiled line exceeding 120 
characters generates the Line 1c (error 65) condition. 
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TEXT-To-BASIC Transformations. TF AHSFOFM generally uses the same statement entry rules 
that the HP-71’s operating system uses for statements entered from the keyboard, with certain excep- 
tions and restrictions. TEAHSFORM accepts a maximum line length of 120 characters instead of the 
95-character keyboard limit. Longer lines are truncated to 120 characters, and generate the Line 

Tao Leora (error 65) condition. Restrictions are that every line must begin with a line number, and 
that an implied [15F statement may not begin with an expression that itself begins with a variable. 
For example: 


TRANSFORM (continued) 
| 
| 

100 3*SIN(A) . 

will be interpreted as | 
100 DISP 3*SIN(A) 

but the statement 
100 A 


generates a syntax error. 


Note: A transformation can take up to several minutes to complete, depending upon the size of the 
file being transformed. 


Error Handling During Transformation. Errors detected during a transformation are handled 
automatically. If the error is a recoverable error (that is an error that will not prevent completion of 
the transformation), a warning message is displayed in the following format: 


TH 


ll 





Lannn: 





” 


The nnnn indicates the line number of the source file line on which the error exists, and “...” indicates 
the warning message. If the computer cannot identify a line number for the source line, nnnn indicates 
the sequential number of the line in the source file. After the transformation is complete, the Syrit ax 
error message is generated if one or more recoverable errors occurred during the transformation. 


When transforming a TEXT file to BASIC, a line having a valid line number but an invalid BASIC 
statement is a recoverable error and results in a warning. In this case the line is converted to a BASIC 
remark statement by preceding it with the characters “! * ”. A BASIC-to-TEXT transformation 
removes these characters. Thus, original TEXT lines that cause an entry error when transformed from 
TEXT to BASIC will be restored when transformed back to TEXT. 
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TRANSFORM (continued) 


If an error is unrecoverable (that is, an error that will prevent completion of the transformation), the 
computer displays the warning message 

TEM HEH: Transform Failed 
and aborts the transformation. If the transformation is out-of-place, the destination file is purged. If 
the transformation is in-place, the file is restored to its original format. After the HP-71 completes 
either operation, an error message identifying the cause of the unrecoverable error appears in the 
display. 


CAUTION 


An error condition that prevents completion of an in-place transformation causes the computer to 
perform a reverse transformation on the portion of the file already changed in order to restore the file 
to its original format. If the reverse transformation is aborted by another error, such as insufficient 


memory, the file is rendered unrecoverable and is automatically purged. Note that in low memory 
conditions with extended keywords supplied by external ROMS or LEX files, there is a remote pos- 
sibility that despite all system safeguards an error that prevents completion of a transformation oper- 
ation can occur during the inverse transformation. For this reason, in-place transformation is not 
recommended in conditions of limited memory or on a file for which you do not have a backup copy. 
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TRAP 


TEA returns the current value of the trap for the specified flag number, and optionally allows you to 


supply a new value. 


Oo Statement W Keyboard Execution 


@ Function M@ CALC Mode 
[1 Operator @ IF...THEN...ELSE 








fs iad new 5 
trap value 





RETURN § teat 


TVL trap vwalue 


Input Parameters 


Item Description 





Restrictions 





flag number Numeric expression rounded to an 
integer. 


new trap value Numeric expression rounded to an 
integer. 


—8 through —4. 






Q through 15. (Refer to “Com- 
ments” on the next page.) 
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TRAP (continued) 


Comments 


You can use TFAF to set, test, save, and restore individual trap values. If an optional new trap value 
is specified, the trap is then assigned the new value. Otherwise, the trap is left unchanged. For in- 
formation concerning trap values, refer to your HP-71 Owner’s Manual. 


A trap value in the range of 3 through 15 is treated in the same was as a trap value of 0. 


Related Keywords 


CE F 





T, OME, TMs, IVL, GVF, UF. 
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UNF 


LIF (underflow) returns the underflow flag number (—5). 


O Statement 
@ Function 
1 Operator 





UNF 


Examples 













M Keyboard Execution 
M@ CALC Mode 
@ IF...THEN...ELSE 









ad 


THEN A=E A= TRAP CUP, oo 


Related Keywords 





in, 


DEFARUL 
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UNPROTECT 


LHF RCOTECT removes the write-protection from one track of a magnetic card. 


@ Statement M@ Keyboard Execution 


Ol Function Ol CALC Mode 
1 Operator @ IF...THEN...ELSE 


UNPROTECT 


Examples 





UMP ROTECT 


Comments 


WHE ROTECT is available only when the HP 82400A Card Reader is installed in your HP-71. When 
you execute LHF ROTECT, the computer prompts you for a card and then allows you to pull the card 
through the card reader once. If the track accessed by the card reader was previously write-protected 
by FEQTECT, the UHFECTECT operation removes the write protection. To remove the write- 


protection from the card’s other track, turn the card around, reexecute UNFROTECT, and again pull 
the card through the card reader. 
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UNSECURE 


LIMSECURE clears the file access restriction that is set by SECURE. 






@ Statement HM Keyboard Execution 
O Function 1 CALC Mode 
C Operator @ IF...THEN...ELSE 


specifier 
KEYS 









Examples 
UNSECURE KEYS RHS SEU RE Sune ae 
UNSECURE "TESTFILE:FORTCZ)" UNSECURE FILE2 
WHSECURE 


Input Parameters 


String expression or unquoted string. File name with optional device 
Default: Current file. specifier. 


- on the current key assignment file, k uz. 









file specifier 





Comments 








SECURE EEYS reverses the effects of % 





You can purge an unsecured file. If such a file is not private, it may be read, listed, and altered without 
restriction. 


Note: All files are unsecured at creation. 


Related Keywords 


FR 





- 
= 


>, SECURE. 
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UPRC$ 


LIFE: (uppercase conversion) converts all lower case letters in a string to their uppercase 
counterparts. 


O Statement M Keyboard Execution 


@ Function O CALC Mode 
1 Operator @ IF...THEN...ELSE 





C—O] +) 


Examples 


AE=UP RCE CARE 3 


Input Parameters 


a 


Comments 












LIFRC# returns a string that is identical to its argument except that all lowercase letters contained in 
the string are converted to uppercase. 


This function is useful when you wish to allow input in lowercase, but require that such input be 
converted to uppercase before determining its value. 
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USER 







@ Statement @ Keyboard Execution 
O Function [1 CALC Mode 
O Operator M@ IF...THEN...ELSE 





= Lar) 
= 
OFF 


Examples 


Comments 


When the User keyboard is inactive, all keys correspond to those indicated on your HP-71’s keyboard, 
and the USER mode annunciator is not displayed. When User mode is active, any user-defined key 
assignments maintained in the k y= file are active and the USER annunciator is displayed. For a 
description of how to redefine keys, refer to the DEF KEY keyword entry. 


opposite status. 


Activating User mode sets system flag —9; deactivating User mode clears flag —9. 


Related Keywords 
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VAL 


FIL (string-to-numeric conversion) converts to a numeric value any numeric expression within a string 
expression. 










Oh Statement M@ Keyboard Execution 
@ Function O CALC Mode 


O Operator M@ IF...THEN...ELSE 








i+ Ofer] +O) 


Examples 


DeVALCOATESL? 23 





Restrictions 
Must contain a valid numeric 
expression. 















String expression. 





Comments 


The parameter string is entered as a numeric expression. 


° Any characters following the first valid numeric expression are ignored. For example, 
WAL a # * would return iz3. 





e Any numeric expression is allowed including those that return Inf or Hah. 





WAAL. cannot interpret the string as a numeric expression, an error results. For soa cet 
‘ ': which the computer interprets as an incomplete expression, causes an If": 
Ee pr Centet 80) condition. 





Related Keywords 
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VER$ 


WER (version string) returns a string indicating the versions of the system ROMs built into your 
HP-71. "EF: # also returns the names of any LEX files present in the computer’s memory or in a plug- 
in ROM. 





Ol Statement 





M Keyboard Execution 
M@ Function [1 CALC Mode 
Ol Operator M@ IF...THEN...ELSE 
Examples 





Comments 


This function can provide useful information to Service personnel should your computer ever need 
service. 





The default string returned by ‘VE indicates the version of your computer’s system ROM set. The 
default string uses the following format: 


HF Fi: 1CCCC 


where each character (C) in the string following the colon indicates the version of each of the comput- 
er’s four system ROMs. 


If there are any LEX files in main RAM, plug-in ROMs or independent RAMs, the HP-71 appends to 
the default string a separate string identifying each of these files. The format for any appended string 
is: 

"name [ : version identifier ] ". 


The number of characters in the 





£ string depends upon the number of LEX files in the machine. 
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WAIT 


AIT causes the computer to wait for the specified number of seconds. 


M@ Statement W@ Keyboard Execution 


O Function [1 CALC Mode 
O Operator @ iF...THEN...ELSE 


Examples 





HAIT WAIT HAT? 3 


Input Parameters 


a 


interval Numeric expression giving number of 0 through 19,531,250,000,000. 
seconds to wait. Both integer and fractional values 
allowed. 





Comments 


To interrupt the waiting period, press the key. 
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WIDTH 


\J20:TH defines the line length for the [i and LIST statements. 









M@ Statement M Keyboard Execution 
O Function 1 CALC Mode 
Ol Operator M@ IF...THEN...ELSE 





Examples 


HIOTH 28 





Input Parameters 


Numeric expression rounded to an 1 to infinity. Arguments exceeding 
integer. 255 are interpreted as infinite. 
Arguments less than 1 are 
interpreted as 1. 








display width 








Comments 











TOTH affects only the displayed output. / H does not set an absolute length on stored lines, 
but rather sets the number of characters for any line you display. If a stored line has more characters 
than specified by the current HItiTH setting, the line is split into two or more lines when included 
in (FSF and LIT operations. For example, if you execute !10%7TH 1, then execute 








AEC 


and 





ELPHOP 


iT 07H affects input prompt displays in the same way. 








304 
WIDTH (continued) 


Using THE in DISF statements reduces the THE function value modulo display width. 


Related Keywords 


QGSP, THPUT, LIST, PHIGTH. 
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WINDOW 


HIHOOE sets the display window size and location. 





@ Statement M Keyboard Execution 
OO Function (1 CALC Mode 
O Operator @ IF...THEN...ELSE 





Examples 


WIDOW 3, 28 WIHGGE 1 


Input Parameters 
Item Restrictions 


| first column Numeric expression rounded to an 1 through 22. 
integer. 


last column Numeric expression rounded to an First column to 22. 
| integer. 
| Default: 22. 





Comments 





A display window specified by 1}: contains the “free portion” of the display that you can access 
and edit. Any portions of the display outside of the current display window are protected fields and 
cannot be edited. Any scrolling is thus performed in the free portion of the window. Any dot pattern 
in a protected field remains unchanged until one of the following occurs: 


e Another Li 





if command clears the protected field in which the dot pattern is located. 


e You perform an IHIT 1 reset operation. (Refer to “Verifying Proper Operation” in appendix A of 
the HP-71 Owner’s Manual.) 


If the current window is [1,22] then the entire LCD is reserved for the display. If the value of the first 
column specifier is greater than 1, HI} i locks six dot columns into the display for each display 





character position not in the window. The effective size of the LCD is reduced by that amount, and 
scrolling occurs within the reduced window. 
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@ 


The @ concatenation character joins statements, which enables you to enter more than one statement 
in a program line or keyboard instruction. 





O Statement M Keyboard Execution 
O Function O CALC Mode 
{J Operator @ IF...THEN...ELSE 





BASIC BASIC 
statement statement 


Examples 





Comments 


Using multistatement lines instead of single-statement lines conserves memory. (Refer to the “BASIC” 
entry under “Files” in the “System Memory Requirements” chart on pages 330 through 332.) 


Most HP-71 statements can be used in multistatement lines without restriction. However, 
CORT, FETCH, and FLlié cannot be followed by an @. 
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The & concatenation operator joins strings. 







; OO Statement M@ Keyboard Execution 
_ O Function Ol CALC Mode 
| MW Operator O If-...THEN...ELSE 





string string 
expression expression 


Examples 


Program segment: 


10 A$=“AMPERSAND: ” 
20 C$="“CONCATENATOR” 
30 DISP A$ & “ STRING” & C$ 


Program output: 
ANPERSAND: STRING COHRCATEHATOR 
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+ 


The + (addition) binary operator returns the sum of its operands. When used as a unary operator, + 
returns the value of its operand. 





O Statement M@ Keyboard Execution 
O Function M@ CALC Mode 
@ Operator @ IF...THEN...ELSE 





[eee HO 


Examples 


Input Parameters 


operand Numeric expression. Subject to operator precedence. 
Also, refer to ‘‘Comments,’’ below. 


Comments 





Executing Inf + ¢~frmf2 results in the Inf-—inf (error 15) condition. 
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The — (minus) unary operator reverses the sign of its operand. When used as a binary operator, x — y 
is defined as x + (—y). 





O Statement M Keyboard Execution 
CO Function M CALC Mode 
@ Operator @ IF...THEN...ELSE 


[eee te 


Examples 


f 

1 

1 

t 
ae 
a 
foe 
. 

i 

‘ 
tie 
rir 
i 
thr 

i 

i 


Input Parameters 


operand Numeric expression. Subject to operator precedence. 
Also, refer to ‘‘Comments,’’ below. 








Comments 


The —x operation reverses the sign of x. (This is true even for + 0 and for NaN.) 


Inf -— Inf results in an Inf—Inf (error 15) condition. 
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K 


The # (multiplication) binary operator returns the product of its operands. 


M@ Keyboard Execution 


O Statement 





O Function @ CALC Mode 
@ Operator @ iF...THEN...ELSE 
@) 
Examples 





Input Parameters 


tem YT enentn [tone 
operand Numeric expression. Subject to operator precedence. 

Cannot multiply Inf by zero. 
Comments 


*& (error 16) condition. 








» results in an Iri 
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The . (division) binary operator returns the quotient of its operands. 














M Keyboard Execution 
™@ CALC Mode 


O Statement 
| OO Function 





| M@ Operator @ iIF...THEN...ELSE 
o 
Examples 
C= F: FRIAHT "ee Hi 




















Subject to operator precedence. 
Cannot divide by zero or divide Inf 
by Inf. 










Numeric expression. 
| 


dividend } 
divisor 







Comments 


The following exceptions can occur: 


e &.~ results in an error 7 condition. 





s) condition. 





en. results in an error 8 (.2 


e Inf-iInm# results in an error 14 condition. 


Related Keywords 
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The * (exponentiation) binary operator returns the first operand raised to the power given by the 
second operand. 


O Statement M@ Keyboard Execution 


O Function M@ CALC Mode 
B Operator M@ IF...THEN...ELSE 





[eee } Ofer 


Examples 
RZ = Hee + ¥°! 
PRINT "H-th Root of « = "EHOCLeHS 


Input Parameters 


Cte [tee |e 


Subject to operator precedence. 


i ion. * 
NUMmIBhiG exPressic Also, refer to “Comments,” below. 





Comments 


The following exceptions can occur: 
e A negative value raised to an non-integer power results in a Heg“Nom-irt (error 9) condition. 
e The value of 1 raised to an Imf power results ina i“ If (error 17) condition. 
¢ Zero raised to a negative power results in a &*r:ea (error 5) condition. 


e The operations &*8 and Inf“ give warnings, but return the default value 1 unless 
OEFAULT OFF is active. (Refer to the DEFAULT OFF/ON keyword entry.) 
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% 


The % (percent) binary operator returns x percent of y for the operation x ™ y. 















O Statement @ Keyboard Execution 
O Function ™@ CALC Mode 
@ = Operator @ IF...THEN...ELSE 


[eeccene +B) ercner 


Examples 


TSRA5 PETHT "18s af Total =") 185T 


Input Parameters 


! 


percent 





Subject to operator precedence. 


Numeric expression. “ ” 
argument Also, refer to ‘‘Comments,’’ below. 


Comments 


The x = y operation is defined by 
x % y = (x/100) * y. 


Executing & % Inf or Inf % & results in the Imf+ (error 16) condition. 





System Characteristics 


Scope of Environments 


An environment is the set of variables, pointers, flags, and other information within which a program or a 
subprogram operates. Three types of environments can exist in the HP-71: 


1. Global environment. This can be accessed by every program and subprogram and from the keyboard. 
For example, a flag set in one subprogram can be tested in another subprogram. 


2. Main environment. This is the default environment. It is active when a subprogram isn’t running or 
execution is not halted in a subprogram. The main environment consists of those variable items and 
channel numbers that are saved when a subprogram is called. Executing END ALL returns the 
computer to the main environment. 


3. Subprogram environment. This is similar to the main environment, except that it is created when a 
subprogram is called. Running a subprogram saves the main environment. A subprogram’s environ- 
ment is saved if it calls another subprogram. When the second subprogram ends, its environment 
is erased and the first subprogram’s environment is restored. When the first subprogram ends, its 
environment is erased and the main environment is restored. 


The illustration on the facing page indicates the components of the global, main, and subprogram 
environments. 
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Global, Main, and Subprogram Environments 








Main Environment (saved) 
Variables 
Arrays 
User-Defined Functions 
Channel Numbers 
Statement Labels 
DATA Statements 
Subroutines 
FOR...NEXT Loops 


Global Environment 
File Names 
Command Stack 
Flags 
Trap Values Subprogram Environment (active) 
Timers Variables 

Arrays 

User-Defined Functions 
Channel Numbers 
Statement Labels 
DATA Statements 
Subroutines 
FOR...NEXT Loops 





A user-defined function can be used only by the main program or subprogram in which the function is 
created. A user-defined function created by a program or a subprogram cannot be used by another pro- 
gram or subprogram. Also, the DATA statements contained within a program or subprogram can be read 
only by FEAD statements. 


Channel numbers listed as parameters in a subprogram’s =\/E statement are not local to that sub- 
program. Channel numbers not listed in a SIE statement are local unless the 3//E statement contains 
no other parameters, in which case the channel numbers in the calling environment are shared with 
those of the subprogram’s environment. 


Variables 


A simple variable and an array variable cannot use the same identifier. 


Note: In the following information, any optional parameter is indicated by a pair of square brack- 
ets, as shown below: 


required parameter [optional parameter ] 





316 System Characteristics 


Simple Numeric Variables 
¢ Identifier: /etter[digit] 


e Types: REAL (default type) 
SHORT 
ITHTEGER 

e Examples: Fi, F= 


Numeric Array Variables 
¢ Identifier: /etter[digit]« subscript[ . subscript]: 
¢ Types: FEAL (default type) 






e Examples: Réit, Hid, 18% 


Simple String Variables 
¢ Identifier: letter(digit]? 
e Examples: Hi, T2# 


¢ Default string size: 32. 
(Refer to the DIM keyword entry.) 


String Array Variables 
¢ Identifier: oe Geek 


e Examples: : 





e Default element size: 32. (Refer to the DIM keyword entry.) 


Array Bounds and Referencing 


The default lower bound on array subscripts at memory reset (ne 
OPTION BASE keyword entry.) 


lest) is 0.(Refer to the 





The default upper bound on array subscripts is 10. (DIM, REAL, SHORT, or IMTEGEF declarations 
specify an upper bound.) 


The maximum upper bound on array subscripts is 65535. 


You can reference entire arrays in F} 





. statements by specify- 


ing only the array name. ee you can use an array name with parentheses and no subscripts. For 
example, you can use T*. instead of the array name alone. 
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Math Reference 


Precedence of Operators 


The table below lists HP-71 operators in their order of precedence. The first line indicates the highest 
precedence. Where an expression contains two or more operators having the same level of precedence, 
those operators will be evaluated in the left-to-right order in which they occur within the expression. 


Performed First 
©... (Nested parentheses are evaluated from the inside out.) 


Functions (such as 21H, FHEG, etc.) 


unary + , unary -, HiT 
oo BI; 

+, =~, § 

t, =, >, #, 7, 22, 25, 
RHE 

OF, EXOR 


Performed Last 


Numeric Precision 


Maximum Value 


12 digits +9.99999999999 x 10**99 
5 digits +9.9999 x 10*4% 
5 digits +99999 







Range of Numbers 


The shaded areas in the following ibustration: indicate intervals that do not contain any HP-71 repre- 
sentable numbers. I !! L i L. are functions that return the endpoints of these 
intervals. fi return the overflow and underflow thresholds respectively. The HP- 
71 representable numbers whose magnitudes lie between EFS and fH ‘EFL are “denormalized.” 
That is, they have the minimum exponent, —499, but contain one or more leading zeroes in the 


mantissa. 
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= ; -~MIHRERL MIHREAL 
: . AaREAL —0.00000000001E — 499 0.00000000001E — 499 MASREAL 
—9.99999999999E499 
-ePpS ae 9.99999999999E499 
~ IHF —1.E—499 1.E—499 | IHF 






Denormalized 
Numbers 


Numeric Expressions 


A numeric expression can include any of the following: 
¢ A numeric constant. 
¢ A numeric variable. 
¢ A numeric function. 


A numeric expression can also be any of the preceding forms, combined by operators (arithmetic 
relational, or logical) or pairs of parentheses. 


ystem Flags 


A memory reset (meticr y 


Flag 


Number 





La 


lost) 


System Characteristics 


clears all of the following flags except flag —61. 





Effect 
When Set 





Warning messages suppressed. 
Beeper is off. 
Continuous on. 
Inexact result (If). 
Underflow (IIH). 
Overflow (G4)! F). 
Division by zero ([1'! =). 
Invalid operation (14). 
User keyboard is active. 
Angular setting is radians. 
Round-off setting. 

Display format. 
Lowercase lock. 

Base option 1. 

Number of display digits. 
Beep set to loud. 

Don't prompt. 

Exact flag. 

AC annunciator on. 

Alarm annunciator on. 
BAT annunciator on. 
PRGM annunciator on. 
SUSP annunciator on. 
CALC annunciator on. 





Keyboard and Display Control 


Input Keystrokes 
through 

(9](a} through 

(Sz) 


[0] through [9] 


SPC 


Q 


} Uppercase and lowercase letters. 


Digits. 
Space. 


Set/Clear 
by User 


Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 


No 
No 
No 
No 
No 


No | 





Period. Used as a decimal point in numbers. 
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(+), E), Gd, 4, 
(SI), (1) 


G) 


a 


0). 90 
(gi) 


(s}(s] 
(9)(8) 
WI, GIO 


(s)(e] 
(JG) 


Ee 

(six) 
(IE) 
4), 9G 
(IL) 





(9)(2] 


Editing Keystrokes 
[4] (gold key) 


~ 





Arithmetic symbols: addition (plus), subtraction (minus), multiplicatior 
(asterisk), division (slash), exponentiation (circumflex), and percent. 


Comma. Used to separate items in commands, statements, and func- 
tions; and to separate keyboard responses to the statement. 
Also used to space between items displayed. 





Parentheses. Used to key in expressions and to dimension variables. 


Exclamation mark. Used for end-of-line comments in program state- 
ments. 


Double and single quotation marks. Used to enclose strings. 


Number sign. Used to specify file numbers of BASIC files in AS21GH 
#,FRIHT #,R ESTORE #,and FREAD # statements. Also used to as- 
sign timer numbers in JH TINER # and GFF TIMER# statements 
and for inequality in relational tests. 


Dollar sign. Used to specify string variables and string functions. 
Ampersand. Used to concatenate string expressions. 


Opening and closing brackets. Used to dimension string variables and to 
specify substrings. 


Statement separator. Used between statements to form multistatement 
lines. 





Semicolon. Used as a delimiter in PETHT, OISF, IH ] 
#, and | [1 # statements, and as a “typing aid” specter in key re- 
definitions. 





Equals. Used to assign values to variables and to test for equality. 
Less than. Used in relational tests. 

Greater than. Used in relational tests. Also used as the BASIC prompt. 
Left brace and right brace. 


Colon. Used as a delimiter and as an “execution only” specifier in key 
redefinitions. 





Question mark. The default prompt for the 
used as a relational operator. 


r statement. Also 


The f-shift key. Used to access f-shifted keywords, commands, and func- 
tions. 


(9) (blue key) 
(CeTAL) 


(OR) 


(HLECHAR] 
(<), 
GII)}, Pa 


(A), 


WK), Wty 


System Keystrokes 
[ON], 


(ALOFF} 


(EDIT) 
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The g-shift key. Used to access lowercase letters, characters indicated in 
blue on the keyboard, and certain editing features. 


Control character prefix. Used to display certain characters from the 
HP-71 character set. 


Lowercase lock. Switches keyboard between uppercase and lowercase. 
Insert/Replace. Switches between insert cursor and replace cursor. 


Backspace. Backspaces the cursor one character position and deletes 
the character at the cursor’s new position. 


Delete character. Deletes the character at the cursor position and shifts 
all succeeding characters one position to the left. 


Delete line. Deletes all characters from the cursor position to the end of 
the line. 


Next port catalog. Used during CAT ALL and CAT: FORT oper- 
ations to access the catalog on the next port in sequence. 


Left and right arrows. Moves the cursor to the left or right across the 
display or, if no cursor, scrolls the display window to the left or right. 


Far left and far right arrows. Moves cursor to the far left and the far 
right of the display. If no cursor, shifts the display window to the far 
left or far right. 


Up and down arrows. Moves the display up and down through BASIC 
program files, through the system and mass storage catalogs, and 
through the command stack. 


Far up and far down arrows. Moves display to first and last line of a 
BASIC program file and catalog, and to oldest and most recent entry in 
the command stack. 


Attention. Turns on the display, clears the display, and interrupts run- 
ning programs. 


Turns the display off. Memory and clock system remain active. 


Reset. When pressed simultaneously, causes a reset to occur. The com- 
puter prompts for one of three initialization settings. 





Typing aid for E17 function. If pressed during a multiple file catalog 
operation, causes the anh displayed file to become the current file. 


- function. 





Typing aid for FET: 


End line. Causes an expression, statement, or command in the display 
to be evaluated, stored, or executed. 
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(Continued on next page.) 





RUN Run program. Runs the current program when in BASIC mode. Note: You can use the CHAR SET statement to change the display character symbol for one or 
(f(SsT] Single step. Displays and executes the next program statement in the more of the default display characters corresponding to character codes 128 through 255. 
current file. 
(g][emps]) Command stack. Displays most recent instruction executed from the | ; i 
keyboard and sets display to command stack. When in the command Decimal . Decimal Default 
stack, this key sequence returns you to the BASIC prompt. j (CHE #) Display (CHE #) 3 
eee Character | Character Keystrokes Character Display 
(9)[ERRM ] While held down, displays most recent error message. Code Code Character 
(9) USER] Toggles user keyboard for one shifted or unshifted keystroke. 
00 0000 0000 0 -None- (9](CTRL] [Sle] 
Escape Keystrok 01 0000 0001 1 : (}LorRt 
PEPEVSNOnes 02 0000 0010 2 =  fal[erac) * 
(g)(CTRL) (SM) Generates ASCII character 27 (escape). The HP-71 responds to the es- 03 0000 0011 3 © (g}[CTRL] 131 3 
cape sequences listed under “HP-71 Display Escape Code Sequences” 04 0000 0100 4 m (g)[cTAL) (D) 132 a 
on page 328. 05 0000 0101 5 Fi (S)[CTRL) (E} 133 B 
06 0000 0110 6 r (9)(CTRL] 134 r 
Display Control 07 0000 0111 7 ‘ (g)[cTRL) (6) 135 ‘ 
e . 08 0000 1000 8 -Blank- — (S)[(CTRL) (H] 136 Bs 
iy Delay function. Controls the rate at which information is sent to and 09 0000 1001 9 o (g)(eTRe} (1) 137 7 
scrolled across the display. 0A 0000 1010 10 -Blank- __-None- 138 by 
PRIOTH Sets line length of output to printer devices. 0B 0000 1011 "1 ms (a)[erAL) (K] 139 
hae ie ee nie 0c 0000 1100 12 un —— (@ICTAL 140 \ 
JTOTH ets line length of output to display devices. OD 0000 1101 13 -Blank- — ()(CTRL] [M] 141 al 
WD MC Sets number of characters in display window. 0E 0000 1110 14 T (9)LCTRL) (N] 142 T 
OF 0000 1111 15 £ (S)LCTRL) [0] 143 £ 
CALC Mode Kevstrok 10 0001 0000 16 a (g)(eTRL) (P] 144 A 
yorenee 11. 0001 0001 17 n (g](CTAL] (a) 145 a 
Causes evaluation of the rightmost operator or function. 12 0001 0010 18 5 (g)(cTAt) (AR) 146 5 
(g](Back] Backup execution. For the current expression, restores the last operator ees ‘3 : (aiteraL) [s] ed : 
or function that was evaluated Ve OO D108 eo 4 (gi{crRt | ae : 
15 0001 0101 21 4 (o\(cTRL) 149 4 
[A], Command stack scroll up, down. Scrolls through command stack. While 16 0001 0110 22 a (9](CTR | 150 a 
in CALC mode, unnecessary to press (9][CMDS] to enter command stack. 17 0001 0111 23 a (9 ](CTRL 151 o 
5 Causes expression to be evaluated and the results of numeric e i 1B. OOK nee ai e (9)(erAL] bisks e 
xpressions 7 
to be stored in the RES variable. E 19 0001 1001 25 ul (g)(CTRE) 153 ut 
1A 0001 1010 26 i (9](CTRL] 154 Ud. 
HP-71 Character S 1B 0001 1011 27 -Blank-  (@)(eTrRL] (9) 155 & 
et and Character Codes 1¢ 0001 1100 28 E -None- 156 E 
The following table shows the HP-71 character set. Where keystrokes are shown to the right of a ee ae oo . (a}[eraL} (9)0) mt = 
character, you can use either those keystrokes or the CHF'# function to display the character. Where no Pe ee 2 (allerat) (3+) i : 
keystrokes are shown to the right of a character, you can use only the CHF function to display that a ae ane a = Ae Noo 159 : 
saarieed (In most cases, the default display characters in the right side of the table are duplicates of 21 0010 0001 33 a (JL) 
e display characters in the left side of the table.) 22 0010 0010 34 " (30) 
23 0010 0011 35 # (9)(#) 
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(Continuation of Character Set/Code Table) (Continuation of Character Set/Code Table) 


Decimal Decimal Default Decimal Decimal Default 
(CHR#) | Display (CHR) | Display Hex | Binary (CHR#) | Display (CHEF) | Display 
Character | Character Character Savarese : Character | Character Character Character 


Code 

























Left | Right 















| K (K]} 203 } 
| 4C 0100 1100 L 204 L 

4D 0100 1101 77 4 [mM] 205 M 
4E 0100 1110 78 H [N} 206 H 
4F 0100 1111 79 o (0} o 
50 0101 0000 80 FE (P} F 
51 0101 0001 81 Gt (Q] a 
52 0101 0010 82 FE [R} FE 
53 0101 0011 83 5 (s} & 
54 0101 0100 84 T T 

: ? 55 0101 0101 85 WW 

é e 56 0101 0110 86 

a a 57 0101 0111 87 HW 

1 1 58 0101 1000 88 ig 

= 2 59 0101 1001 89 ¥ 

5 5A 0101 1010 90 2 

4 4 5B 0101 1011 91 [ (Nm 

5 5 5C 0101 1100 92 “, -None- 

6 6 5D 0101 1101 93 ] nm 

? ? 5E 0101 1110 94 * (9A) 

= 3 5F 0101 1111 95 _ -None- 

a a 60 0110 0000 96 ; -None- 

: : 61 0110 0001 97 a (9]fa) a 
62 0110 0010 98 bi (9]f{b} bi 
63 0110 0011 99 c (S]fe} 227 ic 
64 0110 0100 100 d (9){a) 228 d 

es 65 0110 0101 101 8 (g][e) e 

3 66 0110 0110 102 f (a)f) f 

B (9) B 67 0110 0111 103 a (s){g) a 

A A 68 0110 1000 104 h (s)ih] Fi 

E E: 69 0110 1001 105 i 

c c: 6A 0110 1010 106 J 

th (D) tr 6B 0110 1011 107 ‘ 

E (E} E 6C 0110 1100 108 

F F 6D 0110 1101 109 

5 (G] G 6E 0110 1110 110 

H (H) H 6F 0110 1111 111 

I ) I 70 0111 0000 112 

= J 71. 0111 0001 113 


(Continued on next page.) (Continued on next page.) 
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(Continuation of Character Set/Code Tabie) 


Decimal Decimal 
(THRE #) Display (CHE) 
Character | Character Character 
Code Code 


Default 
Display 
Character 


Keystrokes 





Control Characters 


Characters 0 through 31 in the preceding table are also special control characters defined by the Ameri- 
can Standard Code for Information Interchange (ASCII). These characters (also known as control 
codes) are primarily used in data communications to control peripheral devices. The following table 
shows the standard ASCII definitions for those characters. 


Note Except for the four special control character codes marked with an asterisk, none of the 
characters represented by the following codes perform any control function in the HP-71. Also, 
adding 128 to the character code for any of these four special control characters displays the 
symbol for that code instead of performing the indicated control function. 


Decimal 
(CHE#) 
Character 
Code 


OMAN DOAR WN HA © 
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Control Function 


The Null Character 
Start of Header 
Start of Text 

End of Text 

End of Transmission 
Enquiry 
Acknowledge 

Ring Bell 
Backspace 
Horizontal Tab 
Linefeed 

Vertical Tab 

Form Feed 
Carriage Return 
Shift Out 

Shift In 

Data Link Escape 
Device Control 1 
Device Control 2 
Device Control 3 
Device Control 4 
Negative Acknowledge 
Synchronous Idle 
End of Transmission Block 
Cancel Line 

End of Medium 
Substitute 

Escape 

File Separator 
Group Separator 
Record Separator 
Unit Separator 
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HP-71 Display Escape Code Sequences eset Conditions 


To enter an escape (ESC) sequence, press [9][CTRL] (9)[{] followed by the key corresponding to the 
desired sequence. 


The following conditions exist in the HP-71 when you first install the batteries, or whenever a I &i1-~ 


ori Lost condition occurs or you execute a memory reset—(INIT ( [ON] ). 


















a After the Machine Reset or After 
Press Condition : : 
(a)(CTAL] the Batteries Are First Installed 

0 

and: 

(a} Inserts cursor. 

[N] Inserts cursor (with wrap-around). 

(R] Replaces cursor. ie 

Moves cursor right oo. Aes 

(D} Moves cursor left. Alternate Character Set None. 

Homes cursor. Flags: 

Clears display. All user flags. Clear. 

- h — 
[K] Deletes through end of line. eystemings PMNS = Oe Clee 
Files: 

IE) Tui CUR On File Catalog One file, the system work ¢ ile, which is the current file. 
(g]C<) Turns cursor off. File Access No files are open. 

(E) Resets display. keys File Nonexistent. 

) Deletes character. Numeric ae 

Display Format 
[o} Deletes character (with wrap-around). oe 


Angular Setting 
% Sets cursor position in video monitor. Refer to following paragraph. Random Number Seed 











; ; DEFAULT 
(S)[CTRL] Moves cursor to right of rightmost character. Werebies and Arve Rissdcalcotee: 
(9)(CTAL](0] Moves cursor to leftmost character. OPTION BASE ey 
Round-off Setting Nearest. 
To reposition the cursor to a specific row and column in a video monitor, use the CHR #“ 27 form of Password: 
the escape sequence with the *; symbol as follows: , LOCK Set to null string. 
'EMDLIHE Setting 

DQISP CHEf¢2Pa & "2" & CHEE ktCcolumn:? *% CHE#FECrow? : Clock: 
Using the key sequence (9][(CTRL) (S)[1] (S)[%] (as indicated in the preceding table) instead of SETTINE Bg Gs 
CHRE¢2P" & “%" causes the cursor to move to the column position specified by the ASCII char- Bees oie. 2° a c 
acter code for the first key you press after [%]. : pccuracy Factor (ar) 


(Continued on next page.) 
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Reset Conditions (continued) 


After the Machine Reset or After 


Condition the Batteries Are First Installed 





Programming: 
Current File System work File. 
i a Off. 

Off. 

= Off. 

Warning Messages Displayed. 





Continuous © 





Not set. 
Set to GH and | 
None. 





System Memory Requirements 


Alternate Character Set 3’ bytes, plus 6 bytes per character. 


Command Stack 15 bytes, plus 1 byte for each character in each 
command in the stack, including carriage return. 


Data File Channels 312 bytes for each file opened, plus 212 bytes for 


each new channel number. (Up to 64 files can be 
opened at once.) 
Expressions 
Constants: 
One-Digit Integer Constant 1 byte. 
Multi-Digit Integer Constant 1 byte plus 2 byte for each digit. 


Constant With Fractional Part or 
Exponent > 11 


22 bytes plus ¥2 byte for each digit. 


String Constants 2 bytes plus 1 byte per character. 


(Continued on next page.) 
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(Continuation of System Memory Requirements Table) 


Memory Required 


Item 


Variable References: 
* Simple Variable 


* Array Variable 


Function References: 


* User-Defined Functions 


* System Functions 


Operators: 
* Relational Operators 
* Other Operators 


Substring References 


Files 
BASIC 


TEXT 


DATA 


KEY 


(Continued on next page.) 





1 byte per character in variable name. 


1% bytes, plus 1 byte per character in array name, 
plus memory requirement for subscript expres- 
sion(s). 


1% bytes, plus 1 byte per character in function 
name, plus memory requirement for parameter 
expression(s), if present. 


1 or 3% bytes, plus memory requirement for 
parameter expression(s), if present. 


1% bytes. 
1 byte. 


1% bytes plus memory requirement for index 
expression(s). 


242 bytes for the empty file. Also, in addition to 
the memory used for the statement(s) you enter in 
a line, any single-statement line uses four bytes, 
and any multiple-statement line uses four bytes 
plus two more bytes for each concatenated state- 
ment. (Thus, by using a multiple-statement line in- 
stead of two or more single-statement lines, you 
conserve two bytes per concatenated statement.) 


18%2 bytes plus 2 bytes per line plus 1 byte per 
character plus 2 bytes for end-of-file. 


222 bytes plus record size in bytes times number 
of records. String data items written to the file use 
3 bytes plus 1 byte per character plus 3 bytes per 
crossing of a record boundary. Numeric data items 
occupy 8 bytes. 


18% bytes plus 3 bytes per definition, plus 1 byte 
per character in assigned string(s). 
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(Continuation of System Memory Requirements Table) 





LEX 


BIN 
SDATA 


Plug-In ROM or RAM Device 


Subprogram Calls 


User-Defined Function Calls 





Subroutine Calls 
FOR...MEi#T Loop Configuration 


Pre-allocated System RAM 
Variables 


Simple Numeric 


Simple String 


Numeric Array 


String Array 








Memory Required 





18% bytes plus file’s data size. Requires an 
additional 5/2 bytes of system overhead for each 
LEX file in memory. 


24/2 bytes plus file’s data size. 
18% bytes plus 8 bytes for each record. 


5 bytes per device plus 51% bytes of system over- 
head for each LEX file, if any. 


39¥2 bytes plus 9/2 bytes for each numeric param- 
eter, plus 9% bytes for each string parameter 
passed by reference, plus, for each string param- 
eter passed by value, 2 bytes plus one byte per 
character. 


50 bytes plus 9% bytes per numeric parameter 
plus, for each string parameter, 2 bytes plus one 
byte per character. The function name itself re- 
quires an added amount of memory (as if the 
name were a passed parameter). 


3 bytes each. 
20% bytes for each loop. 


755 bytes minimum. Add 5 bytes for every ROM, 
RAM, or memory-mapped I/O device plugged in. 


92 bytes, regardless of type. 


11% bytes, plus 1 byte per character in a maximal 
string. (For example, a default length simple string 
variable consumes 43/2 bytes, regardless of how 
many characters the variable contains.) 


9% bytes, plus: 
* 8 bytes per REAL number. 
° 4% bytes per SHORT number. 
* 3 bytes per INTEGER number. 


9¥2 bytes, plus 2 bytes for each element, plus the 
maximum element string length times the number 
of elements. 
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Memory Usage During Evaluation of Expressions 


The HP-71 stores expressions in postfix form. During evaluation, the computer copies operands to a 
stack (maintained by the operating system), which temporarily consumes user-available memory. Each 
numeric operand requires eight bytes; each string operand requires eight bytes, plus one byte for each 
character in the string. 


Substrings are extracted by a postfix operation which requires the entire parent string to be present on 
the stack. For this reason, it may be preferable to store related data fields as smaller elements of a 
string array instead of grouping these fields in a single, large string from which substrings are 
extracted. 


Mathematical Discussion of HP-71 Statistical Arrays 


Matched Samples 


A sample is a collection of observations of a random variable. A matched sample consists of one or 
more samples where each observation in a sample is matched with an observation in each of the other 
samples. Each sample has the same number of elements, which is denoted by N. NVAR will denote the 
number of variables (samples). A matched sample data set can then be visualized as a table with N 
rows and NVAR columns. 


Sample Set of Matched Data 






Variable Number 


1 Bo Se 4 ~ an ke pees NVAR 
1 x(1,1)) x (1,2) 2... x 1K). x (A,NVAR) 
2 x(2,1)) x (2,2)... x (2j) «2. x (2k)... x (2,NVAR) 
i x (i,1) x(i,2)... xij) we. x ik). x (LNVAR) 
N X(N,1)) x(N2)...  X(Nj)  ... xX (Nk) X (N,NVAR ) 











Each row of this table represents a point in NVAR-dimensional space and will be called a data point. 
A data point can be considered an observation or realization of an NVAR-dimensional random vari- 
able, resulting in N such realizations. 
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summary Statistics 


For the purposes of performing statistical operations and functions, the HP-71 does not need to store 
the entire data set. Instead, the computer reduces, or summarizes, the data in the following way. Let 
x(ij) represent the entry in row i and column j for i=1,2,...,N and j=1,2,...,NVAR. The summary 
statistics are then: 

N 

NVAR 

TG) = 2x (yj) j=1,2,...,.NVAR 

SQGR) = Z[x(ij) — TYG)/N][x(ik) — T(R)/N] j,R=1,2,..,.NVAR 


T(j) represents the sums of the columns and the S(jk) represents the sums of squares and cross- 
products of the mean-adjusted variables. 


Some calculators and handheld computers with statistical functions accumulate the sums of squares 
and sums of cross-products of the unadjusted variables, 

2x(yj)x(ik), 
rather than the S(jk) Three advantages to using the mean-adjusted sum S(jk) are: 


1. It reduces the potential for loss of significance errors when the data points have non-zero means. 


2. Calculations based on mean-adjusted values are faster than those based on the unadjusted ones. 


3. It is easier to use sample means, variances, and correlations as inputs in place of the original data. 


The TAT statement reserves space for these summary statistics by dimensioning a statistical array. 
This array has one dimension and has length (VVAR+1)(NVAR+2)/2. NVAR is stored in the statisti- 
cal array’s internal representation. The other statistics are stored as 


(N,T(1),S(11),7(2),S(12),S(22),....S(NVAR,NVAR)). 


Multiple matched samples can be stored simultaneously and analyzed in any order by using more than 
one statistical array. 


The =TAT statement specifies the current statistical array. The HP-71 contains only one current 
statistical array at a time. All other statistical arrays are preserved, however, like any array or simple 
variable, up to the limit of memory. A noncurrent statistical array can be made current by specifying it 
with a = TAT variable name statement. 
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Recursive Calculation of Statistics 


A data point V = (V(1),...,.VUNVAR)) is “added” to or “dropped” from the current data set using the 
FOO and CECE statements, respectively. The NVAR numeric expressions in an AOE or DROF 
statement are evaluated and are interpreted as the coordinates of the data point. If less than NVAR 
numeric expressions are included, the missing trailing expressions are assumed equal to zero. 
FiOG: updates the summary statistics according to: 

If N < 0 then display EFF: Invalid Statistic and stop. 

For k = 0 to NVAR 

For J] = 1 tok (skip if k = 0) 
If N=0 then S(jk): = 0 
else S(jk): = S(jk)+(N*V(j)— T(j))(N*V(k)— T(R))/[N(N + 1)] 


Next j 
T(k): = T(k)+V(k) 
Next k 
~N:=N+1 
End. 


CiECF updates the summary statistics according to: 
If N < 0 or 0 < N <1 then display EFF: Invalid 
If N = 0 then display EFF: Inwslid Stat Op and stop. 
For k = 0 to NVAR 
For j = 1 to k (skip if k = 0) 
If N = 1 then S(jk): = 0 
else S(jk): = S(jk)—(N*V(j)— T(J) (N* V(R) — T(R))/[N(N — 1)] 
Next J 
T(k): = T(k)— V(R) 
Next k 
N: = N-1 
End. 


tatistic and stop. 


re 


The CLSTAT statement sets the elements of the current statistical array to zero. This prepares the 
statistical array for accumulating statistics for another data set. 
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Simple Linear Regression 


The simple linear regression model is: 
X(j) = a + b*X(k) + 2, 


where X(j) is the dependent variable, X(k) is the independent variable, a and b are constants to be 
determined (estimated), and e represents random errors (uncorrelated with zero mean and with un- 
known but constant variance). The constants a and b are determined by the method of least squares. 
That is, they are chosen to minimize the residual sum of squares: 


D[x(ij) — a — b « x(ik)]*. 
The solution is: 

b = S(jk)/S(kk), and 

a = [T(j) — b*T(R)\/N. 


Notice that a (constant) random variable equal to one and having the coefficient a is implicitly present 
in the regression model. This interpretation can be quite useful when adding and dropping variables 
(or terms) to or from multiple linear regression models. 


The mean-adjusted sum of squares for this constant variable and any mean-adjusted sum of cross- 
products involving this variable are zero. The sum of the values for this variable is N. Therefore, no 
additional summary statistics need be accumulated in order to implicitly include this variable in the 
data set. 


For these reasons, this random variable (numbered zero) will always be considered present in a data 
set, and zero will be considered a valid variable number for all statistical statements and functions, 
except where explicitly stated otherwise. 


The LF statement specifies the dependent and independent variables. Any variable number in 
[0, NVAR] is allowed to be the dependent variable, and any variable number in [1, NVAR] is allowed to 
be the independent variable.* These variable numbers are stored by the computer. 


If one or two variable names are included in the LF statement, the estimated intercept a is stored in 
the first variable and the estimated slope b is stored in the second variable, if appropriate. 


* For a definition of “variable number” refer to the table on page 334. 








The IEEE Proposal for Handling Math Exceptions 


Introduction 


The IKEE Radix Independent Floating-Point Proposal divides all of the floating-point “exceptional 
events” encountered in calculations into five classes of math exceptions: invalid operation, division by 
zero, overflow, underflow, and inexact result. Associated with each math exception is a flag that is set 
by the HP-71 whenever an exception is encountered. These flags remain set until you clear them. Each 
of these flags can be accessed by its number or by its name. 


Setting and Clearing Math Exception Flags 


You can clear and set the math exception flags in the same way as any flag, except that flag names can 
be used as well as flag numbers. 
Examples. Both of these statements clear the invalid and inexact flags. 

CFLAG IML. INK 


The keyword MATH specifies all math exception flags as a group. It can be used with the 3Fi 
and {FLA statements. 


The Five Math Exception Flags 


The following describes the conditions that set each of the math exception flags: 


¢ IL. Invalid operations are those for which no real value can Senate ba eee as a result. 
Some examples that set the I\'L flag are SGR¢-12, LOG¢-13, ACOS¢e3, and Ge 


e (32. The division by zero flag is set whenever finite operands give rise to an exact infinite result. 
Typical examples: i-@, LH¢ G2, TAH* 38% in degrees, and 8° *-5>, 


e GF, The overflow flag is set when: 


1. The finite 12-digit rounded result r of an operation satisfies |r| > MAXREAL, such as 
r = 1£499«10. 


2. A SHORT variable is assigned a finite value r such that the five-digit rounded value r’ satisfies 
Ir’l > 9.9999E499, such as r = 9.99996E499. 
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3. An IHTEGEF variable is assigned a finite value r which, when rounded to an integer r’, 
satisfies Ir’| > 99999, such as r = 100000. 


4, A decimal string representing @ a value greater than & 


r 


value, such as VALLE 


is converted to a numeric 














e UHF. The underflow flag is set when: 

1. The 12-digit rounded result r satisfies 0 <Irl < 1E—499 and will not be represented exactly 
in its destination. For instance, 1E-43%.-2 sets the WHF flag, although 1E-4233-188 
depends on the default value dictated by the TRAP “LHF > setting. If TRAP*UNF > = 2, 
then the denormalized result . 441E-42% is exact, and HF is not set. (The next topic 
covers default values.) 

2. A SHORT variable is assigned a value r such that the five-digit rounded result r’ satisfies 
0 <Ir’l < 1E—499 and will not be represented exactly in its SHORT destination. 


= is converted to a numeric value. 





3. A decimal string representing a number less than £ 





Liiei. 


identical to the exact result. This is true for most HP-71 functions, including all functions speci- 


‘. Generally, the inexact flag is set if and only if the rounded real result of an operation is not 









fied by the IEEE Proposal (+, -, Pes ° , and FED). For example, ie%, = cS and 
i + 1£-186 allset IH® while i- SOR¢1é>, and i + & do not set IHS. 
However, for some compound operations, such as *“"', and for most statistics operations, it is imprac- 


tical to determine exactness in all cases. Thus, for these compound and statistics operations, the fol- 
lowing is true: if IH is not set, the result is exact, but some exact results may (overcautiously) set 
IH. This is also the rule for any sequence of HP-71 operations. If IH is not set by a sequence of 
operations, then no rounding errors have occurred, and you can be sure that your result is exact. But if 
IH‘ was set by any of the operations, it is not necessarily true that the result is inexact. For example, 
the statement *=SGR¢53.« SGR¢#2 sets IH even when ::=5. This is because the HP-71 reacts to 
the rounding errors committed in 3@F¢5 2 and S@R¢#3, but, of course, does not detect the fact that 
they compensate each other. Although some exact calculations will set IH», these cases have been kept 
to a minimum so that the flag will retain its usefulness in more complicated calculations. 





Extended Default Values 


When exceptions occur, it is sometimes desirable to continue the calculation by using a default value 
for the result. The HP-71 extends the normal range of floating-point values to include, as proposed by 
the IEEE, special default results which can be used with relative safety for each exception. 


By setting the appropriate traps with the TEAF function or with the DEFAILT statement, you can 
select the action of continuing the calculation with a choice of default values or of suspending the 
program with an error message. 
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A TEHAF value of = causes all math exceptions to return the new default values introduced by the 
TERE Proposal. 


Default Values with TEAF Value of = 
and GF TIOH FOUND HERE Active 








Not a Number, explained below. 





Inf oor ~Trt 
tee oe =the } Mathematically exact infinity, explained below. 


, —&, or a Denormalized 
Number 


Explained below. 


Not a Number 


When an invalid operation (1%) occurs, the IEEE default result is the value “Not a Number,” dis- 
played as Hatt. This value conveys the information that an invalid operation has occurred and the 
result of the calculation is not a number. 





Example. When you enter the following three concatenated statements, the display will first show 
the current trap value associated with the I'L flag, whatever it happens to be. This example assumes 
the current trap value is i. Then the two following statements will display the outputs shown. 











Input/Result 
CTVL 22 @ £=86-8 @ DISP é 
1 i..2% returns the current ep value 
anal sets = as the new trap value for 1% 
WR & 2=. returns a warning, since the current 
TL trap value is now =. 
Hah OISF = returns the value of =. 


If you do not wish to preserve an I'/L trap value of =, execute TRAF¢ 
TRAP YTV Go. 





‘Lis or 


A Hah value propagates through the usual math operations so that it generally appears in the final 
result. For example, using = from the above example, 7 * = + i returns the original Nati with no 
exceptions being raised. In the event that two HaHs enter one operation (for example, = + =), then 
the result will also be HH. Exceptions to this are logical operations and numeric comparisons, which 
always return 4 or 1. 


aN can be stored ina SHORT or IHTEGER precision variable. 
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Since Hat has no ordering with the other FEAL numbers, when Hsfis are involved in certain compari- 
sons the I'L flag will be set. Refer to the topic “The Unordered Comparison Operator” on page 343. 


The Hs described above are called Quiet Haris. There is also another type of aH called a Signaling 
Hat. This Hal is created directly by the user when the }15H function is executed, and at this time no 
exception results. Later, a Signaling Hal will set the I'L flag whenever it is first encountered in a 
math operation. The Signaling aH then becomes a Quiet Mati. The Signaling Hal can be used to 
initialize any uninitialized data so that the I 4!L flag will be set whenever this data unexpectedly enters 
into a calculation. 


Infinity 





When the 2/2 or GF exception occurs, the IEEE Proposal specifies default values iim and 
These behave like mathematical infinity in subsequent operations. For example, Int. 
4 = Inf and -f-8 = -Inf. 








The IHF function returns the value In . Inf can be stored inan IHTEGER, SHORT, or & 


variable. 


Denormalized Numbers and —0 


On many computers, the simple test for x—y=0 does not guarantee that x=y. For, 
when |x| and lyl are small enough to be near the underflow threshold, x — y ey andersley to 0 wily 


out having equality. For instance, with DEFAULT OH active, 1.22345E- - 1.,2346-459°7 
produces a WEH: Under flow warning, followed by &. 


The IEEE Proposal specifies that gradual underflow be implemented. This requires that small results 
be denormalized to the minimum exponent of the number system. Gradual underflow is implemented 
when CEFAULT EXTEHO is in force. With DEFAULT EXTEHO active, the above example 
L.S2456-497 - 1,224E6-457 does not underflow. Rather, the HP-71 returns the 


denormalized result #.G5E-493,. 


Here’s another example: 1.2245E-43541E-% displays, after the warning, the rounded, 
denormalized result &. SHHG08H00123E-493, with OF TION FOUND HEAR active. The expo- 
nent of the normalized form of this result is given by the EXFOHEHT function. Executing 


EXPOHEHTCRES> gives -388,. 






When the magnitude of the rounded result is smaller than 1*10 °° (QF TIOH REOUHMD) HEAR ac- 
tive), it underflows to & and the LIHF flag is set. To retain more information about the underflow, 
the value & preserves the sign of the underflowed value. For instance, a result of —1*10°* would 
underflow to —4. 
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This extra information in the sign of zero can be useful for carefully written programs designed to 
handle exceptions like 1. ~&2 automatically. Otherwise, in unexceptional calculations, # and -& 
behave in the same way. They. even compare equally, so that ~é is true and -& is false. 








The sign of zero will normally | be preserved through functions F(x), where F(0)=0. For example, 


®* returns & and 56 &> returns -& (recall that ~& is not less than %). 





Classes of Numbers 





The inclusion of TF = default values for math exceptions extends the normal range and type of 
numbers. This extended range is divided into 12 classes as shown in the table below. 


Classes of Numbers 


Value or Range of x 


Denormalized (# 
(- 
Normalized (EF 
(“EF 
Tm? oor ~inf 
Quiet + Hak 
Signaling + I: 








Examples. The value returned by (1.25 identifies the class of numbers to which its argument 
belongs. The sign of the result indicates the sign of the argument. The returned values are shown in 
ey format with [I L ESTEHD o While you can execute =7T0 and GEFAULT 

FS in either BASIC or CALC mode. 






Returns ~=. 
Returns =. 


Returns —%. 





Returns 4. 
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The Unordered Comparison Operator 


The introduction of #ia+ to represent the result of an invalid operation requires a new comparison 





operator, 7, to complement the usual relational operators =, =, and =. The comparison #7" is 
true if and only if one (or both) of # and ‘f is isi. With any comparison of ® and ‘ exactly one of 
four conditions is true: 

is true). 


1. # is less than ‘. (= 
} is true). 
is true). 
is true). 


2. # is equal to ‘. 
3. is greater than ‘’. 
4, is unordered with 





( ry 


*’ is no longer identical to * 





One consequence of fia} is that : ¥', as the following table shows: 


Differences Between the Operators <=: and # 


Equivalent To 


Comparison 


. HOT OS 





If either “ or % is Haft, a is false but b is true. Note that if ™ is sti, then the comparison “= is 
false. In fact, the comparison “= can be used to test if * isa Hah. The CLASS function (page 
49) can also do this test. 


The invalid (IVL) flag is set for numerical comparisons whenever the expressions being compared are 
unordered and the relational operator being used to compare the expressions contains = or + but 
not %. That is, the IVL flag is set when the expressions are “unexpectedly” unordered. Note that even 
though the flag is set, no Hat is created. 


Example. Assume the current trap value for the invalid flag is 1. This example assigns a trap value of 
2 for the invalid flag so the HP-71 will respond to an invalid operation with a warning and a default 
value rather than an error and an operation halt. 


Input/Result 


TEAPCIVL, 22 & G=8-8 & R=5 
The HP-71 displays the current trap value for the 
invalid flag. 


bent 


WE: a8 Next, the computer warns that an invalid oper- 
ation has occurred and sets the IVL flag. 
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Example using the Relational Operator Table. Suppose that you wish to evaluate x < = y, where 
x = —37.3 and y = —O0. Since the x-value corresponds to row 2 (n) of the table and the y-value cor- 
responds to column 3(~#) of the table, the tabular result is «. Thus, the table indicates that, in this 


case, x < = y is true. 


Input/Result 





The result of &.& is “Not a Number,” since the 
trap value for the IVL flag is 2. 


Display the answer to the question: is Q less than 
or greater than R? 








The computer sets the IVL flag and warns that a 
comparison involving at least one |: has been 
attempted. 





ay 
End 


C is assigned 4, not Hati. The comparison is 
false. Since Q is a Hal, the only true comparison 
would be one involving the unordered comparison 


operator, ‘?. 


Table of Comparisons (X Compared to Y ) 


The table shown below illustrates the ordering relation- 


ships among values represented by + infinity, finite posi- Less Than 
Equal To 


tive and negative numbers, + zero, and NAN (not-a- 
number). The symbols used in the table are described in 
the box to the right. In the table itself: 


n = a real negative number. 


Greater Than 
Unordered 





P = areal positive number. 


True Results of Comparing X to Y 








Glossary 


Introduction 


This glossary describes terms used in both the HP-71 Reference Manual and the HP-71 Owner’s 
Manual. If a term you are looking for is not described in the glossary, refer to the HP-71 Owner’s 
Manual index. 


Special Symbols 
& String concatenator. 
Used to close a channel. (Refer to the ASSIGN# keyword entry on page 23.) 
iB Separates statements in multistatement lines. 
i Allows end-of-line comments in program lines. 


Two special uses: 
¢ The default IHFLT prompt. 
© Used as a relational operator. (See unordered.) 
nee Displayed in lieu of a line number to indicate an execution error in a non-BASIC program. 
E Two uses: 
¢ Exponent—precedes a power of 10 in a floating point number. 


* Indicates a private and secure file in a catalog entry (an “execute only” file). 
F Indicates a private file in a catalog entry. 


Indicates a secure file in a catalog entry. 
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Terms 
A 





accessory: Devices or modules that plug directly into the HP-71, such as the HP 82400A Magnetic 
Card Reader or the HP 82420A 4K Memory Module. 


accuracy factor: See adjustment factor. 
active environment: The currently accessible local environment. 


actual parameter: An expression or variable that is passed as an argument to a subprogram or 
function. In a CALL statement, an actual parameter can also be a channel number (preceded by 
#). See also formal parameter. 





address space: The range of memory locations the computer can access. The HP-71 address space 
is 1,048,576 four-bit locations. 


adjustment factor: The amount of correction applied to the internal clock of the HP-71. The 
adjustment factor is expressed as the number of seconds the HP-71 waits before adding (or 
subtracting) one second to correct a slow (or fast) clock. Sometimes referred to as accuracy factor. 
Refer to the EXACT entry in the Keyword Dictionary. 





adjustment period: The period delimited by successive executions of EXACT. The computer uses 


this period to calculate the adjustment factor. 


alternate character set: A set of user-defined characters that are represented by the ASCII char- 
acter codes 128 through 255. The HP-71 alternate character set is entirely user-definable. 


annunciators: Symbols that appear in the left and right ends of the display window to indicate 
certain machine conditions. 


ANSI BASIC Standard: A standard for the BASIC language that was developed by the American 
National Standards Institute. Two standards have been developed. The first was ANSI X3.60-1978 
and is referred to as “ANSI Minimal BASIC.” The second, referred to as the Level 1 standard, was 
proposed by ANSI subcommittee X3J2. As of the original printing of this manual, the second 
standard was not yet adopted. 


argument: A parameter. 
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arithmetic operator: One of the elementary operators: +, -, £, -, “, %, and @! 


array: A variable containing an ordered collection of values. Each value is termed an element. An 
element is specified by an array name followed by a list of one or two subscripts enclosed in 
parentheses. (The rules governing numeric and string array names are the same as those for 
numeric and string variable names.) All elements of an array are of the same data type. See also 
numeric array and string array. 


array base: The lowest-numbered subscript that can be used to reference an element of an array. 
The base of an array is enomeuicaly set at the time that you create the eriay and is determined 
by the current ¢ [ EASE setting (1 or 0). The HP-71 default FP TIOH E setting is 
0. 





array element: One of the values in an array. An array element is referenced by array name and 
element subscript(s). 


ASCII: The American Standard Code for Information Interchange. This is a standard used by the 
computer industry to represent characters by numeric values. This code enables different types of 
computers to exchange information. Each HP-71 character, either built-in or user-defined, cor- 
responds to a decimal code in the range 0 through 255. 


ia gs 


assignment statement: A LET statement or an implied £7 
value. 


statement used to give a variable a 


available memory: The part of RAM that is not currently being used to hold files, variables, ar- 
rays, or any system control information. (ME! returns the amount of available memory in main 
RAM, in a specified plug-in memory device, or in an independent RAM.) 


B 





base: See array base. 
base part: See mantissa. 


BASIC: Beginner’s All-purpose Symbolic Instruction Code. BASIC is the HP- 71’s programming 
language. Also refers to a file type. 
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BASIC mode: The computer mode in which you can write BASIC programs and perform most 
keyboard operations. It is distinct from CALC mode. 


binary operator: An operator that performs its operation on two expressions. It is placed between 
the two expressions. The following binary operators are available: 















* The “-” operator is a unary operator that can 
be used as a binary operator. 





See also unary operator. 


bit: The smallest unit of memory, equivalent to one binary digit. A bit can have one of two values: 0 or 
1. 


bit pattern: The pattern formed in the HP-71 display by a group of binary digits (bits). Each bit 
represents one dot on the display. (The bit pattern is described under “Defining Alternate Char- 
acters” on page 132 in the HP-71 Owner’s Manual.) 


branch: To transfer program execution to a specified program statement. 


byte: A standard unit of memory equivalent to eight binary digits (bits). Depending on the value of 
each bit, a byte can have a value of 0 through 255. Each ASCII character occupies one byte of 
memory. See also bit and nibble. 


C 


CALC mode: A mode in which you can perform keyboard calculations and view intermediate re- 
sults. Pressing switches the computer between CALC mode and BASIC mode. 
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calling environment: The local environment of a program or subprogram that has referenced a user- 
defined function or called a subprogram. When -a program or subprogram calls a subprogram, the 
calling environment is maintained in an inactive status until the called subprogram ends. See also 
active environment, environment, global environment, local environment, and main 


environment. 

calling program: A program that executes another program or subprogram using the CALL 
statement. 

calling statement: A statement that transfers execution to a subroutine (GOS1B) or a subprogram 


(CALL). When a subroutine or a subprogram ends, program execution returns to the statement 
following the calling statement. 


ARC: A keyword that specifies the HP 82400A Magnetic Card Reader as a device. This keyword is 
used in COF'* or CAT statements. 


card file: A file that resides on one or more magnetic cards. 


earriage-return (CR): A control character (character code 13) that causes the cursor to return to 
the left edge of the display. 


carriage-return/line-feed (CR/LF): A sequence of two characters normally generated by the ter- 
mination of keyboard entries and FR INT and [.ISF statements. The (a} and keys send car- 
riage-return/line-feeds to display devices. 


catalog entry: A display line of information showing the name, protection, type, length, creation 
date and time, and port (if any) of a file in memory or on a mass storage medium. 


channel: A path through which the computer stores and retrieves information from a data file. A 


channel is assigned a number and is associated with a file when you execute ASSiIGH#. 





channel number: A number assigned to a channel at the time the channel is associated with a 
specific data file. 


character: An elementary symbol, such as a letter, numeral, punctuation mark, or other special 
symbol that can be displayed on the HP-71. The HP-71 has 128 predefined ASCII characters and 
128 user-definable characters. 
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character code: The numeric value, ranging from 0 through 255, associated with a character. For 
example, the character code for Fi is 65. (Refer also to “HP-71 Character Set and Character 
Codes,” pages 322 through 326.) 


character delay: The length of time between successive horizontal scrolls in the display. When the 
computer displays a line longer than 22 characters, it scrolls the line through the display one 
character at a time, from right to left. The character delay is the length of time a portion of that 
line is displayed before the computer scrolls it one character. This value can be set using the 
LAY statement. 








| string: A group of characters whose character codes represent a bit pattern for a user- 
defined character set. This string is an argument the user supplies to the CHAR SET 





“ET statement. 





close a file: To dissociate a file from a channel. You can close a file by executing A= 


command stack: A portion of main RAM that stores the five most recent commands entered from 
the keyboard. You can access the command stack by pressing [9] [ENDLINE]. 


concatenate: ‘To join string expressions (with #:) or to join statements (with f) on a single line. 
(Some statements cannot be followed by @. The Keyword Dictionary entries for such statements 
include this information.) 


conditional branch: A type of conditional execution in which a program branch occurs as a result 
of a conditional test. 


conditional execution: The execution of a statement or statements based on the outcome of a 
conditional test. 


conditional test: A test based upon a logical expression or an implied comparison between two 
values, asin IF or OH... GOTO/GOSUB/RFESTORE statements. 


continuous on: A condition in which the automatic shut-off feature of the computer is disabled. 
This condition can be set on the HP-71 by setting flag —3. 


contrast value: The argument used by the COHTFEAST statement to adjust the viewing angle of 
the display. 
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control character: One of 32 characters that controls the operation of a printer or display. The 
character codes for the control characters are 0 through 31. 


CR: See carriage return. 
CR/LF: See carriage return/line feed. 
current file: The file that receives the program lines you type into the computer. Also, the current 


file is the default file for the following operations: 


e Pressing the key. 
+ without specifying a file name. 





e Performing most file operations when no file is specified. 


Note: The “current file’ designation can be changed by FUH, EOQIT, CHAIH, CALL, FURGE, 
TRAHSFORM, CLAIM PORT, andFREE FORT. 


current key assignments: The key definitions in the system | == file. These definitions are 
the assignments that become active when the User keyboard is active (USER annunciator 
displayed). 


current line: The program line at which the computer is positioned. You can display the current line 
by executing FETCH with no argument. If a program is paused, the line containing the suspend 
statement (the statement at which execution will resume if you press {f][CONT]) is the current line. 
When you run a program, the current line (as displayed by executing (f][FETCH] or FETCH without 
an argument) does not change unless the program is paused by [ATIN], FALSE, or [SST], or if an 
error or warning condition occurs. If the program is paused, the current line contains the state- 
ment at which execution will resume if you press (f][(CONT]. When a running program is suspended 
by FALSE, the current line is the line containing the statement after the PALISE. 


current statistical array: The statistical array most recently selected by executing 2TAT. You 
can define several statistical arrays, but you can perform statistical operations on only the current 
statistical array. 


cursor: A blinking symbol that indicates the point on the display line at which characters can be 
entered or deleted. 
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D 


data item: A numeric expression, string expression, or unquoted string contained in a 
statement. 





data pointer: The computer’s internal mechanism for indicating the next [iTA item to read. You 
can reposition the data pointer using F: ‘E. See also file pointer, pointer, and program 
pointer. 





data type: A category in which a data item falls. HP-71 data types are: 
e String 
° Real 
e Integer 


e Short 


Also, a simple variable differs in data type from an array variable. 
debug: To locate and correct errors (particularly logical errors) in a program. 


default setting: A setting (such as the display contrast value) that the HP-71 uses until you 
specify a different setting. 


default value: A value supplied by the HP-71 in either of the following cases: 
e If an optional parameter is not specified in a statement or function. 


e If an improper operation has occurred, thus requiring a substitute value so that execution can 
continue. 


degrees setting: The ! 
guments and results in degrees. 





FHGLE setting used for expressing trigonometric function ar- 


delimiter: A character, such as a comma, that separates items in an input list or separate arguments 
supplied to a statement. 


denormalized number: A floating point number that has a true exponent less than — 499. (Refer to 
the section entitled “The IEEE Proposal For Handling Math Exceptions”—page 338—for more 
information about denormalized numbers.) See also gradual underflow. 


destination file: The file that is created or modified as the result of a copy, merge, or transform 
operation. 
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device identifier: A special system device word. HAIN refers to main RAM; CAFO and FCED refer 
to the optional magnetic card reader; FFT refers to plug-in memory and independent RAM. The 
FORT device word can be followed by an optional port specifier for referencing a particular plug-in 
port. 





port 
device specifier: A colon (:) followed immediately by a device identifier. 


device 
identifier 


digit: One of the following characters: 0, 1, 2, 3, 4, 5, 6, 7,8, 9, for decimal numbers. Also includes A, 
B, C, D, E, F, for hexadecimal numbers. 


dimension: Used as a noun to refer to either the maximum length of a string variable or the num- 
ber of elements in an array. If an array’s base is 0, the number of elements is equal to the maxi- 
mum subscript value plus 1. If an array’s base is 1, the number of elements is equal to the 
maximum subscript value. “Dimension” is also used as a verb to describe the execution of [iI to 
set the dimension of a string variable or an array. 








direct execute key: A key or keystroke combination that, when pressed, executes one or more 
instructions without altering the display. Refer also to the GEF EE‘ entry in the Keyword 
Dictionary. 


display format: The way that numeric information appears in the display. Refer to the FIX, SCI, 
ENG, and STD entries in the Keyword Dictionary. 


display line: The line currently in the HP-71 display. It can be up to 96 characters in length, minus 
zero or more character positions for the prompt. The display window displays up to 22 characters 
at a time and can scroll back and forth along the display line. 


dummy array variable: A formal parameter that is indicated by a variable name followed by ¢ : 
for one dimension or «, > for two dimensions. 
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editing: Using keyboard operations to add, delete, or alter information in either the display or a 
file. 


end-of-file mark: An internal marker placed by the computer to indicate the end of information 
in certain files. 


end-of-line sequence: The sequence of characters indicating the end of a line. The sequence usu- 
ally consists of a carriage return and a line feed, and is sometimes called the end-of-line indicator. 
You can use the E _IHE statement to set an end-of-line sequence for the F iT and 
FLIST statements. 








entry slot: The left-hand opening of the card reader slot. Magnetic cards are inserted through this 
opening. 


environment: The combination of the local and global environment that can be accessed by a pro- 
gram or subprogram. See also active environment, calling environment, global environ- 
ment, local environment, and main environment. 


EOL indicator: See end-of-line sequence. 


wo 


EPS: The smallest normalized number representable on the HP-71: 1 .8E-49 


error condition: A condition in which the computer cannot perform an operation. An error con- 
dition results in an error message. For further information, see section 9, Error Conditions, in 
your HP-71 Owner’s Manual. 


error message: A message the computer associates with a given error. You can view the most re- 
cent error message using EEF M£ or [9] . In some cases, a warning message occurs instead 
of an error message. For further information, see section 9, Error Conditions, in your HP-71 Own- 
er’s Manual. 


escape character: The control character whose character code is 27. Used as the first character in an 
escape sequence. This character can be generated on the HP-71 by pressing (9](CTRL) (9)[I] or by 


—~— 


evaluating THE #273. 
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escape sequence: A sequence of characters, the first being the escape character, that controls the 
operation of a display or printer. Escape sequences that control the HP-71 display are listed on 
page 328. 


evaluate: To compute the value of an expression. The result is always a string or numeric value. 
exception flag: See math exception flag. 

exit slot: The right-hand opening of the card reader slot. Magnetic cards exit through this opening. 
exponent: See floating point number. 

expression: See numeric expression and string expression. 

external medium: See mass storage medium. 


F 


field specifier: A sequence of one or more symbols used in a format string to indicate the printer 
or display format for a data item. 


file: A set of lines or other data in memory or on a mass storage medium. A file can be manipulated 
as a single unit and has a unique name. 


file name: A string of one to eight characters that specifies a file in memory. The first character 
must be a letter. Remaining characters may be any combination of letters and digits. The HP-71 
automatically changes lowercase letters to uppercase letters. In general, file names can be speci- 
fied by string expressions or unquoted strings. A blank character terminates a file name. See also 
reserved word. 


file pointer: An internal mechanism the computer uses to indicate the position in an open file 
where the next read or write operation on that file will occur. 
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file specifier: An unquoted string or a string expression that, when evaluated, indicates the name of a 
file and, optionally, the device in which the file is located. 


|} 


specifier 








file type: The characteristic format of a file. A file type is indicated by an unquoted string. The 
HP-71 recognizes the following file types: 


e £85 1c (BASIC program). 

! (machine language program). 

i (fixed-length record data file). 

(key definition file). 

: (language extension file). 

(same format as TEXT). 

e SCATA (serial data file from the HP-41). 

e TET (variable length record file of character data). 


final character position: The position of the last character to be replaced by an assignment to a 
string variable. Also refers to the last character of a substring. A value greater than the variable’s 
current string length is interpreted as equal to the current string length. A value less than the 
start character position is interpreted as specifying a null substring immediately preceding the 
start character position. The default value is the current string length. See also start character 
position. 


flag: An internal system variable that can have two possible values, 0 and 1, which correspond to the 
“clear” and “set” states. Refer to the FLAG, CFLAG, and SFLAG entries in the Keyword Dictionary. 


floating-point number: A number represented internally by the HP-71 in the decimal format 
m * 10° 
where m is the mantissa, which is a 12-digit number in the range 
1 <= ImlIl <= 9.99999999999 
for normalized numbers, and 
|m| <1 


for denormalized numbers; 
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and where e is the exponent, which is a 3-digit integer in the range 
0 <=Ilel <= 499, 





formal parameter: A variable name that appears in a UE [EF FH statement. A formal 
parameter either references or assumes the value of a an actual parameter passed to it. You can 
specify a channel number as a formal parameter in a =1/£ statement by using # followed by an 
integer constant in the range of 1 through 255. 





format string: The characters in an INAGE, OISF USIHG, or PEIHT USIHG statement that 
specify the formatting of information sent to display and printer devices. 





free a port: To use F! F to set aside a portion of main RAM as independent RAM. 


function: A built-in routine that can operate on arguments and produces a single string or numeric 
value. A user-defined function is a function that is defined in a BASIC program using the [EF 
Fi statement. 


G-H 





global environment: The set of files, flags, and other settings that are accessible to any program, 
subprogram, or user-defined function. See also active environment, calling environment, 
environment, main environment, and local environment. 


gradual underflow: A process by which numbers too small to be represented in normal floating 
point format are represented instead by the minimum allowable exponent and a mantissa less than 
1 (for example, 0.0123E—499). These values are called denormalized numbers. 


hexadecimal address: A location in memory specified by a base 16 number. 
hexadecimal digit: A digit 0 through 9 or a letter A through F. 
HHH:MM:SS: Hours, minutes, and seconds. 


hierarchy: A prescribed order in which data is ordered or operations are performed. Refer also to the 
information under “Precedence of Operators” on page 317. 


HP-IL: Hewlett-Packard Interface Loop. A means of controlling peripherals used by the HP-71 and 
other computers. 
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Identifier: A string expression or unquoted string that identifies a file and/or device. 


IEEE default value: The default values specified by the IEEE Floating Point standard. These 
values can be supplied by the HP-71 when math exceptions occur. (Refer to the section entitled 
“The IEEE Proposal For Handling Math Exceptions” for further information about IEEE default 
values.) 


immediate execute key: A key or keystroke combination that, when pressed, displays an instruc- 
tion, then executes it. Compare with direct execute key. Refer also to the DEF KEY entry in the 
Keyword Dictionary. 





independent RAM: RAM that is separated from main RAM by executing FREE 
dependent RAM contains files and is referenced by its port number. 


inexact result: A numeric result that cannot be exactly represented in the HP-71 floating point 
format, such as an irrational number or a number having a repeating decimal. 


IHF: A function used to return the HP-71 representation for infinity (Inf). 


initialize a variable: To assign an initial value to a variable. In the HP-71, all numeric variables 
and array elements are initialized to zero when created by executing DIM, REAL, SHORT, and 
I &. All string variables and array elements are initialized to the null string when neler 
by executing DIM. 





input: To enter data from the keyboard or from a data file. Also refers to the data itself. 
integer value: A number that has no fractional part. 


instruction: A generic term for all operations that can be performed on the HP-71, including any 
statement, function, or operator (with its corresponding operands). 


interchange file: A file of type TEXT (or LIF1) written to a mass storage medium and used to 
interchange information between the HP-71 and other computers. 
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interface: The circuitry that connects a computer to other devices and enables them to function 
together. 


VO: Abbreviation for input/output, indicating an operation that either receives input from a device 
or sends output to a device. The HP-71’s built-in input and output devices are the keyboard and 
display. The card reader is both an input and an output device. 


a ee 


key definition: The current functionality of a key or keystroke combination, which can be to dis- 
play a string of characters and/or to execute one or more instructions. Refer also to the DEF KEY 
entry in the Keyword Dictionary. 


key name: A string expression that identifies a key. A single-character string refers to the key that 
enters that character. (Letters can be uppercase or lowercase.) A two-character string in which the 
first character is upper- or lowercase “f” or “g” refers to the (f}- or (9} shift of the specified key. A 
string beginning with # and followed by one to three digits refers to a key number. For further 
information, refer to the DEF KEY entry in the Keyword Dictionary. 


keyboard buffer: An area of main RAM in which the computer stores keystrokes until it can 
process them. The keyboard buffer can contain up to 15 keystrokes. 


keyboard execution: To perform HP-71 operations from the keyboard, as opposed to operations 
performed by a running program. 


KEYS: A reserved word that specifies the system key file. When used, it must be an unquoted 
string. 


i:eus file: The system file that contains the current key redefinitions. This file is named & #4u5. 
To reference it, use the KE’’S keyword. 


keyword: A word having a predefined meaning in the HP-71. Usually a statement, function, or 
operator. — 
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label: A quoted or unquoted string, immediately followed by a colon, that identifies a program 
statement. A label can precede any statement within a BASIC program, and can follow a line 
number, an @, or another label. That is, multiple labels can identify the same statement. 


A label can consist of one to eight characters. The first character must be a letter. Each of the 
remaining characters can be either a letter or a digit. The HP-71 converts all letters in program 
labels to uppercase and places the label within single quotes. 





label reference: A string expression or unquoted string used in GOTO, GOSUE, and other statements 
to transfer execution to the statement immediately following the corresponding label. A label refer- 
ence contains the same string as its corresponding label. See also label. 


language extension (LEX) file: A type of file used to define new keywords and to extend HP-71 
capabilities. LEX files can be maintained on mass storage media and in the computer’s memory. 


least significant bit: The bit contributing the smallest amount to the value of a binary number. In 
the owner’s manual and the reference manual, it refers to the rightmost bit of a binary number. See 
also most significant bit. 


left justify: To write a string beginning at the leftmost column of a display or print field. 
LEX file: See language extension (LEX) file. 

LIF: See logical interchange format (LIF). 

line editing: Adding to, modifying, or deleting characters in the display. 


line-feed: A control character (decimal code 10) that causes the HP-71 to advance to a new display 
line. 


line number: An integer constant in the range 1 through 9999 that identifies a program line. 
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local environment: The environment that the HP-71 defines for exclusive use by a specific main 
program or subprogram. See also active environment, calling environment, environment, 
global environment, and main environment. 


logical error: An error in a program’s design. A logical error can result from using a faulty al- 
gorithm or from simply keying in a program improperly. Logical errors aren’t detected by the 
computer, but are evident from faulty program output. 


logical expression: A numeric expression used in a conditional test. Evaluated as true if nonzero, 
and false if zero. Usually includes relational operators. Refer also to the IF... THEN... ELSE 
entry in the Keyword Dictionary. 


logical interchange format (LIF): A mass media format that is common to several Hewlett- 
Packard computers. This format enables different computers to interchange programs and 
information. 


logical operator: An operator that returns a logical value (0 or 1). The logical operators on the 
HP-71 are GF, AHO, EXOR, and HET. 


loop counter: The simple numeric variable in a FOR ...HEXT loop that controls the number of 
loop iterations. 


looping: Repeatedly executing a series of statements, usually until a specified condition is satisfied. 


M 


main environment: The local environment of a main program. The main environment is also active 
when no program is running or suspended. See also active environment, calling environment, 
environment, global environment, and local environment. 


main program: A program that is not called by another program or subprogram, but is typically 
executed by (RUN], FLIH, or CHAIH, 


main RAM: The memory used by the computer to create the main environment or subprogram 
environments. (The computer uses part of this memory to maintain operating information that is 
not directly accessible to users.) Main RAM is distinct from independent RAM. (Main RAM is 
referenced by MAIH. Creating a file either when no device is specified or when MAIN is specified 
causes the HP-71 to create the file in main RAM. Refer to “Device Names” in your HP-71 Own- 
er’s Manual. 
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mantissa: The normalized part of a number displayed or printed with an exponent in scientific 
display format. For example, the number i . 2? iy has i.5?2 as its mantissa and i? as its 
exponent of 10. See also floating point number. 





mass storage device: An I/O device such as the HP 82400A Magnetic Card Reader or an HP 82161A 
Cassette Drive that you can use to copy files between memory and mass storage media. 


mass storage medium: A magnetic card, cassette, or disc on which you can store computer files. 


math exception: An event that occurs during evaluation of a numeric expression and is in one of 
the following categories: 


e Invalid operation. 
e Division by zero. 
e Overflow. 

e Underflow. 

e Inexact. 


Depending upon the trap value that corresponds to the exception, the HP- 71 can either treat 
such events as errors or supply a default value for the expression. 


math exception flag: A flag that the HP-71 sets whenever a math exception occurs. The five math 
exception flags are: 


e IL (invalid operation). 
e G2 (division by zero). 


e GF (overflow). 


LINF (underflow). 


IH (inexact result). 
MAXEEAL: The largest finite value the HP-71 can represent, which is: 9.99999999999E499. 


memory reset: A condition in which the memory of the computer is cleared of all programs, data, and 
other information. This happens when you execute IHIT: 3 (in which case independent RAM is 
protected) or remove the batteries for an extended period (independent RAM is not protected). To 
execute an IHI1T:%3, refer to “Memory Reset, BASIC Mode, and the BASIC Prompt” in section 1 
of your HP-71 Owner’s Manual. 
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message number: A number that identifies an error, warning, or instructional message. Error mes- 
sages and their corresponding numbers are listed on pages 380 through 392. 


MIHREAL: The smallest positive value the HP-71 can represent, which is the denormalized number 
0.00000000001E — 499. Refer to the MINREAL entry in the Keyword Dictionary. 


mode: A condition of the computer that determines which operations can be performed. For exam- 
ple, a BASIC program can be edited in BASIC mode only; it cannot be edited in CALC mode. 


module: A device that fits into one of the HP-71 ports and extends its memory or its capabilities. 


most significant bit: The bit contributing the greatest amount to the value of a binary number. Often 
referred to as the leftmost bit. 


multiple-statement function: A user-defined function that contains more than one program 
statement. 


multistatement line: A line containing two or more BASIC statements concatenated by the & 
symbol. 


N 





HAH: The HP-71 function that returns a Signaling NaN. When entered from the keyboard and used 
in an expression, it signals the computer to set the I'!L flag and supplies the value HaH (not-a- 
number). 


NaN: An abbreviation for Not-a-Number. This is a default value supplied for invalid operations 
(operations that set the IL flag) when the I4!L exception trap is set to 2. NaN is supplied for 
such invalid operations as 0/0. 


nested loop: A FOF...HEXT loop contained within another such loop. 
nested subroutine: One subroutine that is invoked by another subroutine. 


nibble: One-half of a byte; equivalent to four bits. The HP-71 individually addresses nibbles in 
memory. 
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normalized number: A number represented internally by the HP-71 in the decimal format 


m * 10° 


where m is the mantissa, which is a 12-digit number in the range 
1.00000000000 <= Im| <= 9.99999999999, 

and e is the exponent, which is a 3-digit number in the range 
—499 <= e <= 499, 


null string: String of zero length, specified by ‘‘' or *". 
numeric array: An array containing elements that are numeric values. 
numeric constant: A fixed numeric value within the range the HP-71 can represent. 


numeric expression: A valid combination of values and operators that produce a numeric result. 
The following diagram describes the syntax of a numeric expression. 


binary 
operator 
constant 
unary numeric 
——< aa Ieee sete ae 
S ae a ms 
S 


string 
expression 



















numeric 
function keyword 
user-defined numeric 


function name 











string relational 
expression operator 
numeric 
expression 


Note: The “ binary operator cannot be followed immediately by a binary operator. 
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numeric function: An operation (that is, an HP-71 keyword or a user-defined function) that, given 
the appropriate type, number, and range of arguments, returns a single numeric value. Some 
numeric function keywords, like FE, require no arguments. 


numeric variable name: A letter or letter-digit combination that represents a location in memory 
where you can store numeric information. 


numeric variable specifier: Designates a simple numeric variable or a numeric array element 
that is to receive a new value, as in F , LIMFUT, LET, and LE. 


numeric 
variable name 
















subscript 





subscript 


O 


open a file: To associate a file with a channel number. Opening a file enables the computer to read 
and write information to that file. A file is opened by executing ASS 1GH#. 


operand: A numeric or string value upon which an operation is performed. 


operating system: A collection of built-in programs that control the overall operation of the com- 
puter, performing such tasks as interpreting and executing BASIC programs, assigning places in 
memory for files, processing keyed-in information, controlling the display, and performing 
calculations. 


operator: A symbol that combines or compares the values of two expressions. Arithmetic, rela- 
tional, and logical operators result in a numeric quantity; the string operator (%:) results in a 
string quantity. 


output: Information that the computer sends to a device such as a printer or display. 
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parameter: The numeric or string information acted on by a keyword. Also, numeric or string in- 
formation used by a function to determine the function’s value. Parameters passed to a 
subprogram can be passed by reference or by value. See reference parameter and value 
parameter. 


pass by reference: To pass a variable as an actual parameter to a subprogram so that it can be 
altered. 


pass by value: To pass an expression value as an actual parameter to a subprogram or user-defined 
function. A variable is passed to a subprogram by value only if it is enclosed in parentheses (which 
ensures that it cannot be altered by the subprogram.) All parameters passed to user-defined func- 
tions are passed by value. 





password: A string expression specified in the Lick statement. A password prevents 
unauthorized use of the HP-71. Refer to the LOCK entry in the Keyword Dictionary. 


peripheral: Any external device on a standard interface controlled by the HP-71. 


pointer: An internal mechanism the computer uses to indicate the next piece of information to 
process. The HP-71 uses pointers to access information such as data items, files, and program 
lines. See also data pointer, file pointer, and program pointer. 


port specifier: A number of the form m.nn or m that identifies one of the computer’s ports. The 
value for m is in the range from 0 through 5; nn is in the range from 00 through 15. (Values of nn 
less than 10 must be expressed with two digits; for example 09, 08, ... 01.) If the port specifier is 
contained within an unquoted string, the specifier can be designated by a numeric expression. 


precision: The number of significant digits a computer uses when it computes and stores a numeric 
value. The HP-71 performs computations in 15-digit precision and stores in 12-digit precision. 


precedence of operators: The order in which mathematical operations are performed by the 
computer, based on the types of operators in an expression. Refer to “Precedence of Operators” on 
page 317. 


predefined function: Any functions that are defined for you by either the HP-71 or by a language 
extension file present in the computer. 
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private file: A file on a magnetic card or other external medium that can be copied into memory 
and run, but which cannot be changed or recopied. (A private file in memory can be run and/or 
purged, but cannot be copied.) 


program: A set of instructions that performs some computing task and controls the input, process- 
ing, and output of data. You can store programs in BASIC files and in BIN (binary) files. 


program line: One line of a BASIC file; contains a line number and one or more statements. 


program pointer: The mechanism used to identify the next function or statement to be executed 
in a BASIC program. See also pointer. 


program scope: The environment of the current program or subprogram. This environment deter- 
mines which variables and statement identifiers can be referenced. 


program unit: A program, subprogram, or user-defined function that performs a specified task. 


prompt: The symbol that appears at the left edge of the display (the right edge when in CALC 
mode) to indicate readiness for user input. Also, a text string used in an IHFLIT statement to 
indicate that the user should key in some information. 


protected field: A portion of the display or a display line that cannot be overwritten. The lI H-— 
statement defines protected fields in the 22-character display window. Escape sequences can 
define protected fields in the 96-character display line. 






COR 


R 
Sa 


radians setting: The GFTIOGH ANGLE setting used for expressing trigonometric function ar- 
guments and results in radians. 


radix mark: The mark, such as a decimal point, that separates the integer portion of a number from 
its fractional part. 


RAM: See random access memory. 


random access memory (RAM): Nonpermanent memory circuits in which a computer can read 
and write. RAM requires a constant source of power to retain its memory. Compare with read- 
only memory (ROM). 
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random file access: The process of reading from or writing to a specified record in a data file. 


random seed: A number used by F:HLi to generate a random number. You can set the random seed 





using FF 


read-only memory (ROM): Permanent memory from which a computer can only read. ROM re- 
tains its memory when disconnected from a power source. 


real value: A numeric value represented as a floating point number. 
record: The smallest addressable unit of a data file. 

recursion: A process or procedure that is defined in terms of itself. 
recursive subprogram: A subprogram that calls itself. 


reference parameter: A parameter that can be changed by the subprogram to which it is passed. 
See also parameter and value Parameter. 


relational operator: A binary operator that compares two arguments and returns a 0 or a 1 based 


on the outcome of the comparison. The following relational operators are available: <, =, >, ==, 
hs, <>, #, and ? 


reserved word: A word that has a predefined meaning in the HP-71 and cannot be used as a file 
name unless the word is part of a string expression. The reserved words are: TO, ALL, KE’’S, 
CARO, and INTO. The reserved words are a subset of the HP-71 keywords. 


ROM: See read-only memory. 
ROM-based file: Files residing in read-only memory. 


round: To adjust the least significant digits of a number according to digits that were either trun- 
cated or cannot be represented due to limits of precision. 


rounding error: The error resulting from rounding a quantity by deleting the less significant digits 
and applying some rule of correction to the part retained. For example, 2.6641 can be rounded to 


2.664 with a rounding error of .0001. 
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round-off setting: Any one of four settings that determine how the computer rounds numbers in 
arithmetic operations. Refer to the OPTION ROUND entry in the Keyword Dictionary. 


routine: A program, program segment, user-defined function, or subprogram that performs a spe- 
cific task and supports the execution of a larger program. 


run-time error: An error that occurs during execution of a program or individual keyboard 
instruction and is not due to a syntax error. See also logic error. 


scope: The range of operation or accessibility of a program, statement, user-defined function, file, 
setting, or other information. 


scroll: Apparent horizontal movement of characters across the display or apparent vertical move- 
ment of program lines, command stack items, or catalog entries through the display. 


scroll key: The (A], [¥], and (>] keys, and their (9]-shifted counterparts. 
SDATA file: A data file with a fixed record length of eight bytes. 
secure file: A file that cannot be purged, altered, or declared private. 


sequential file access: The procedure of reading from or writing to successive records in a data 
file. 





ANGLE 





setting: A flag or operating condition (such as the (@! 
part of the global environment. 


= setting) that is 


shifted keystroke: A keystroke that is preceded by pressing the [f]- or (9]-shift key. 





short value: A numeric value that is represented according to the SHOET format. 


signaling NaN: A NaN entered from the keyboard. Such a NaN, when used in a subsequent math 
operation, causes the HP-71 to set the IL. flag. 
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simple numeric variable: A variable name (a single letter or a letter and a digit) representing a 
memory location in which a single numeric value has been stored. 


simple string variable: A variable name (a single letter followed by # or a letter and a digit 
followed by #) representing a memory location in which a single string value has been stored. 


single step: To execute a program one statement at a time using (Ssst]. Also, to evaluate an 
expression one operation at a time while in CALC mode. 


source file: A file that contains information that the computer either reads or transfers to another 
file. 


start character position: The position of the first character to be replaced by an assignment to a 
string variable. Also refers to the first character of a substring. Values less than 1 are interpreted 
as 1, and the default value is 1. For an assignment, the value cannot exceed the string variable’s 
maximum length. See also final character position. 


start-up string: A string that is specified in the S7ARTUF 
mand when the computer turns on. 


statement and executed as a com- 





statement: A BASIC instruction that can be executed in a running program or from the keyboard. 
Statements can be concatenated with @ to form a multistatement line. 


statement identifier: A line number or label reference that specifies a program statement. 


statistical array: A numeric, one-dimensional array in which summary statistics are accumulated. 
Statistical arrays are created using the S7AT statement. 


string: An arbitrary sequence of characters that is not regarded as a number. In general, you can 
specify such a sequence as a string expression or as an unquoted series of characters. 


string array: A one-dimensional array having elements that are strings. 


string constant: An arbitrary sequence of characters delimited by quotation marks ('...' or 
".."). Also called a quoted string. 
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string expression: A valid combination of string components that produces a string result. The 
following two diagrams describe string expression syntax and components. 


String Expression: 


(&) 


component 









String Component: 


OL freer 
ts eet ets oe 
subscript oD) 


string 
function Keyword 
(FN ) user-defined string ($) 


function name 


Extension 
A 
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parameter 





string 
expression 


ee eee ee 
final 
character position 


string function: An operation (that is, an HP-71 keyword or a user-defined function) that, given 
the appropriate type, number, and range of arguments, returns a single string value. Some string 
function keywords, like require no argument. 


Extension 
A 
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string variable name: A letter or a letter-digit combination followed by #, that represents a 
location in memory where you can store character information. 


string variable specifier: Designates a simple string variable or a string array element (or a por- 

tion of that string) that is to receive a new string value, as in FREAD, READ, ITMPUT, 
Ld IT, and LET. The portion of the destination string variable to be replaced is specified by 
the start character position and the final character position. The computer always begins the 


substitute string at the start character position. 


oa) 


subprogram: A set of program lines that forms a routine that is independent of any main program 








within the file in which it’s stored. A subprogram is delimited by the SiJE and & 
statements. 
subroutine: A program segment that begins execution as a result of a GUGLUE statement and that 


returns control when it executes a FETLIF:H statement. 


subscript: A number that specifies the row (or column) location of an array element. A subscript 
value must be less than or equal to the array dimension limit, and greater than or equal to the 
array base. 


substring: A portion of a string variable; contains zero or more contiguous characters. To specify a 
substring, follow a string variable specifier with a numeric expression (or numeric expressions) 
enclosed in brackets (C 1). 


string 
variable specifier 






start 
character position 






final 
character position 


suspend statement: When a program is suspended, the statement at which program execution will 


resume when you press [f] [CONT]. 





suspended program: A program that has been interrupted without affecting its program control 
information. The SUSP annunciator is displayed when a program is suspended. A suspended pro- 


gram can be resumed by pressing : 
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syntax: The rules governing the spelling of keywords, variable names, operators, file names, etc., 
and the construction of statements and functions. 


system file: A file that is designated by the computer for a special use. Two such files are 
ke e and keys. System files can be identified by their lowercase spelling in a catalog 






hich 


entry. 





system flag: A flag used by the computer to indicate a condition, such as a low battery or an 
overflow in a calculation. System flags are numbered from —1 through —64. 


system message: A message displayed by the computer to give instructions. 


T 


tab: To move the cursor to a specified column. 





TRAE: A keyword that moves the & T position ahead to a specified column. 
text: An arbitrary collection of characters. 


TET file: A file composed of textual information in a form that can be transmitted to other comput- 
ers. In the HP-71, the TEXT file type is identical to the LIF1 file type on the HP-75. 


timer number: An integer from 1 through 3 that is used in an GH TINER# statement to specify 
a system timer. 


track: One of two read/write channels on a magnetic card. 


trap: To detect certain exceptional conditions when they occur in calculations and to take an action 
based on the type of exception and the setting of its corresponding trap value. Refer to “The 
IKEE Proposal for Handling Math Exceptions” section that begins on page 338. 


trap action: The actual computer response to errors as determined by the trap value. 


trap value: A value associated with the five math exception flags to indicate how the computer 
responds to the errors that set those flags. A trap value can be 0, 1, or 2. 
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trappable error: Any error that, when it occurs, allows use of an OH EFROF branch or subroutine 
to take some action other than halting the program; an error that either sets one of the five math 
exception flags or can cause a branch to occur during an OM ERROR condition. 


truncate: To cut off a portion of a string or number. For example, the IF function truncates a 
number at its decimal point. No rounding occurs. 


typewriter key: A key that normally displays a letter, digit, or other symbol. 


typing aid: A key or keystroke combination that enters a string of characters when pressed, as if 
they had been typed in. Typing aids can be user-defined. Refer to the DEF KEY entry in the 
Keyword Dictionary. 


U-V 


unconditional branch: A branch that occurs every time the statement is executed, as when pro- 
gram execution encounters a {iT statement. 


unary operator: An operator that performs its operation on one operand. It is placed in front of 
the operand. The following unary operators are available. 


e — : Reverses sign of its operand. 
e +: Identity operator. (This is a binary operator that can be used as a unary operator.) 


e HOT: Logical complement. 
See also binary operator. 
underflow: A condition in which the computer cannot represent a very small result within its nor- 


mal range of precision. Some results that cause an underflow condition can be represented as de- 
normalized numbers. 


unquoted string: A series of characters, regarded as a string, that is not enclosed in quotes. 


unordered: A relation in which a value is neither greater than, equal to, or less than another value, 


as when a NaN is compared to another value. An unordered relation is tested by the * operator. 


user-defined function: A numeric or string function that a user defines in a program by means of 
CEF FH and EHD CEF statements. 
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user-defined function name: fF} followed by a letter and an optional digit. A user-defined string 
function name always ends with #. 


user flag: A flag whose use is determined by the user. The user flags on the HP-71 are those num- 
bered 0 through 63. 


user keyboard: The set of key redefinitions in the current & == file that are activated by press- 


ing (1) (USER). 


value parameter: A parameter that cannot be changed by the subprogram to which it is passed. 
Value parameters include numeric expressions, string expressions, and variable names enclosed in 
parentheses. See also Parameter and reference parameter. 


variable name: Consists of a letter followed by an optional digit, and is used to identify a variable. 
String variable names end with #. See numeric variable specifier and string variable 
specifier. 


variable number: An integer identifying a particular statistical variable. 
verify: To check a magnetic card to ensure that information was properly written to it. 


W-X 


warning condition: A condition in which either a math result needs a default value or the com- 
puter has detected an undesirable hardware condition (such as low batteries). 


work file: A system file existing as a BASIC scratch file in main RAM. 


FH: An abbreviation used in either an error message or a displayed line to refer to a function in a 
plug-in ROM or language extension (LEX) file when the ROM or LEX file has been removed from 
the HP-71. 


“MORO: An abbreviation used in an error message or a displayed line to refer to a keyword defined in 


a plug-in ROM or language extension (LEX) file when the ROM or LEX file has been removed 
from the HP-71. 





Errors, Warnings, and System Mesexges 


This section contains the error, warning, and system messages related to the HP-71 computer. For 
messages related to devices that can be connected to the HP-71, please refer to the manuals for those 
devices. 


Introduction 


This section contains two listings: 


1. An alphabetically-ordered listing of error, warning, and system message names, with their cor- 
responding error numbers. You can use this listing to determine the number of any message. 


2. A numerically-ordered listing of error, warning, and system messages, with a description of each 
message. 


An error message begins with EFF: and names the error type. In most cases, an error halts execu- 
tion, which indicates that the computer cannot perform a pending operation. A warning begins with 
FH: and names the warning type. A warning indicates that a default value has been substituted for 
a value that the computer could not compute, and does not halt execution. Some messages can be 
either error messages or warning messages, depending upon the arithmetic trap values. An error or 
warning message displayed during program execution indicates the line number causing the error or 
warning, such as EFF L2&: (error at line 30) and HEH LSS: (warning at line 95). 


A system message is usually a procedural message, such as a prompt for card reader operations. For a 
description of error and warning conditions, refer to your HP-71 Owner’s Manual. 


Alphabetical Message Listing 


Messages beginning with nonalphabetical characters are placed at the end of this listing. 


























Message Message Number 

Cat: Aliagnm them EHOLH...... 96 ESEEWE Ma CR earcmieisctcs aie ate eters ee ot 3 
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Biss ToS. Tae ic. otea ace ese e te Ste deve someone 31 Fide IO RPen woos +See Se els ws 62 
fice Hot Frurid .. ccc cee eee 64 Rachie VRP erie Go chine ae ete ee ae 61 

Fo tS nsec eevaer eax’ souehianeyets 54 | Peg De Te Be Sa ieee eee sattiacee ds 
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(Continuation of Message Table) 
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Numerical Message Listing and Descriptions 


Math Errors (1 through 21) 


| Message and Condition 


Under flow 
The magnitude of a result is too small to fit exactly into its destination format. Sets UNF 
(underflow) flag (—5). 

Deere f liu 
The magnitude of a result is too large to fit into its destination format. Sets OVF (overflow) 
flag (—6). 

ESPOHEHT¢ a3 
Indicates attempt to compute the exponent of a zero argument. Sets DVZ (division-by-zero) 
flag (—7). 

TAH=Trif 
TAH argument is an odd integral multiple of 90 degrees. Sets DVZ (division-by-zero) flag 
(—7). 


A reg 
x¥, where x = 0 and y < 0. Sets DVZ (division-by-zero) flag (—7). 


x¥, where x = y = 0. Does not set an exception flag. 
x/y or x DIV y, where x = y = 0. Sets IVL (invalid operation) flag (—8). 


x DIV y or x/y, where 0 < Ix! < Inf and y = 0. Sets DVZ (division- by-zero) flag (—7). 
HeghMimrim Lit 
xY, where x < 0,0 < lyl < Inf, and y is noninteger. Sets IVL (invalid operation) flag (—8). 


Attem 

(—8). 

An argument of a function, operation, or statement has the correct data type, but lies outside 
the domain of definition of that function, operation, or statement. In some circumstances sets 
IVL (invalid operation) flag (— 8). 


(Continued on next page.) 
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Math Errors (continued) 


baa Message and Condition 


12 
¢ LIT: Attempt to compute the logarithm of 0. 
° LOGP 1: If argument equals —1. 
Sets DVZ (division-by-zero) flag (— 7). 
LOG erie 2 


Attempt to compute the logarithm of a negative number. 


LOGF 1: If argument is less than —1. 
Sets IVL (invalid operation) flag (— 8). 
Infedin¢ 
An operation requires the division of an infinite dividend by an infinite divisor. Sets IVL (invalid 
operation) flag (—8). 


mfo-dng 


4 


An operation requires the subtraction of an infinite value from another infinite value of like 


sign. Sets IVL (invalid operation) flag (—8). 
Inf ee 
An operation requires multiplying an infinite argument by a zero argument. Sets IVL (invalid 
operation) flag (—8). 
“Drf 
Attempt to raise +1 or —1 to an infinite power. Sets IVL (invalid operation) flag (—§8). 
Attempt to raise an infinite argument to the power of zero. Does not set an exception flag. 


An input (parameter or data) is a signaling NaN. Sets IVL (invalid operation) flag (—§8). 


ieoie rior 
LPP cSt 


A comparison involves at least one NaN and either a = or * operator without the ‘ oper- 


operation) flag (—8). 
[Triexact 


The result of a function or operation may not be exact. Sets INX (inexact result) flag (—4). 
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System Errors (22 through 27) 








Error 
Number 


Message and Condition 








During a card reader operation, warns that the battery level is low and continued operation 
may cause incorrect results. 


23 





The integrity of information in memory has been disrupted such that the computer cannot 
process the information. This can be caused, for example, by deleting a calling program while 
its corresponding subprogram is executing. At this point, due to Le memory disruption, the 
HP-71 may not operate properly until you execute an { 








CAUTION 


Executing | clears all of the HP-71’s main RAM. Refer to your HP-71 Owner’s 


Manual. 





24 





Generally, insufficient memory available to complete an operation. Specifically, indicates in- 
sufficient memory for the following functions to perform their indicated operations: 


TiM#: Creating the \/O buffer needed to open the file. 
iF: Copying in the specified file. 







‘: Storing the alternate character set. 


et Creating the destination file. When copying to a card, building the card header in 
main RAM. 


Creating a variable with the specified dimensions. 


Creating a statistical array for the specified number of variables. 





T: Creating a file that does not already exist. 





i? es ri There is not enough memory to save the needed | 
information. 
°* FREE FORT: There is not enough memory to remove RAM from main RAM. 





ft The file specified is on an external device and there is not enough memory to copy 
the file into main RAM. 


: does not exist and 






- Attempting to purge the current file wen the i 
there is not enough memory to create the wears 








(Continued on next page.) 
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System Errors (continued) 


Message and Condition 


25 Module Pulled 
A module was removed while the computer was turned on. Doing so causes a system 
reconfiguration and, if any ROMs have moved in address space, causes an automatic 
EIT. The system work file is now the current file. 


26 Configuration 
A configuration error has occurred, such as too many ROMs for the address space or insuffi- 
cient memory to build all of the configuration tables. The computer should operate satisfac- 
torily, but will not find all of the plug-in memory and I/O devices. 

27 Invalid AF 
An invalid value was specified for the clock adjustment factor. (Executing either AF (param- 
eter) or EXACT with an adjustment factor whose absolute value lies between 0 and 10.) 





Program Errors (28 through 56) 







Message and Condition 


La Et 















° FEIHT #: The data items in a print list cannot fit into the specified record. 





* REAOG #: A random access read from a data file has specified a record that has fewer 
data items than the number of items in the read list. 





30 Pt Het Foured 
A statement identifier that is not in the current program scope has been referenced. For 
example, occurs when FETCH references a label that is not in the current file. 

31 Type 





The HP-71 cannot use a variable, result, or quantity as it has been specified. Can be gen- 
erated, for example, by referencing an existing variable as an array. 


32 Hen Dats 


Data for FE cannot be found. 





33 


Found 


TH 
ve 
sage 





CEF: A function was not being evaluated when the computer executed EH 





* Fi: Attempting to execute a user-defined function that is not defined in the current 
program. 








(Continued on next page.) 
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Program Errors (continued) 


Message and Condition 


BPH Het Feurid 
The language extension (LEX) file required to execute a function cannot be found. 
SWORD Mat found 
The language extension (LEX) file required to execute a statement cannot be found. 
Farameter Mismatch 
The number or type of the actual parameters ina CALL statement or function reference 
does not match the number or type of the formal parameters in the corresponding SUE or 
iEF FH statement. 
String Ovel 
Either a string result is too long for the given destination ora STARTUF string exceeds 95 
characters in length. 
Mumeric Trput 
IHMFLET requires numeric input. (Reprompts you for input.) 





Too Many Inputs 
Too many items entered in response to an IHF LIT statement. (Reprompts you for input.) 
Too Few Inputs 
Too few items entered in response to an IHFLIT statement. (Reprompts you for input.) 
Chral# Hot Found 
The ales channel number has not been assigned by an HSS1GH # statement. 
FOR uw. HEAT 
The HP-; 7 has encountered a F UF statement that is not going to be executed, and can- 
not find a corresponding HE#T statement. This can occur, for example, where a state- 
ment such as FUR I = 1 TO -S STEF .5 occurs without a corresponding 
ae .T statement. 





ccm 


a is 
AT H statement has been encountered for which a corresponding F iF statement can- 
not be found. 





iE statement. 


(Continued on next page.) 
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Program Errors (continued) 


Message and Condition 





An image list has one or more errors, as follows: 





© Carriage return symbol not followed by a delimiter. 
¢ Unrecognized character in the format string. 
* Illegal use of image symbols. For example: 
° © in a string field. 
® Mixed [, %, and = symbols in a numeric field. 
© Adjacent © or F. 
¢ © or F beginning or ending a numeric field. 
® © or F adjacent to radix or exponent specifier. 
® Specifying more than one = or fF 
* Leading = or ! with no following digit or radix specifier. 
* Leading . or & with no following ©. 
® Omitting the closing quote on a quoted string. 
® Specifying a multiplier for a symbol that does not allow one. 
© Specifying a zero multiplier or a multiplier greater than 9999. 
® Following a multiplier with a comma or closing parenthesis. 
® Specifying a multiplier for a unit digit’s =. 
® No matching closing parenthesis. 
® Closing parenthesis without opening parenthesis. 








or statement references a line number that has 
no statement, or the output item is not of the type specified in the image list. (For 
example, a numeric output field may be matched to a string item.) 





A field in an inane list does not have enough digits specified to the left of the decimal point. 
This can also occur when the number is negative and the implied negative sign reduces the 
number of specified digits by occupying the leftmost digit. Also occurs when an E symbol in 
a numeric field would result in a displayed exponent having more than three digits. 











(Continued on next page.) 
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Program Errors (continued) 

























Message and Condition 






Invalid TRE 
TFIE column rounds to a value less than 1. A warning condition occurs and a value of 1 is 


supplied. 
49 Suk Hot Found 

ALL: The called subprogram cannot be found. 
50 Wap Cortex t 


An attempt has been made to explicitly or implicitly create or destroy a variable within a mul- 
tiple-statement user-defined function, where that variable is already defined as either a des- 
tination in an assignment statement or as a function parameter. 

51 Invalid Stat Array 
No valid statistical array is currently defined.Sometimes occurs when redimensioning an exist- 
ing array within a user-defined function when the pending assignment statement’s destination 
is a variable element in the array. 

52 Invalid Statistic 
The sample size is invalid for AUG, CROF, LE, MEAH, PREG’, or SDE, or a sum of 
squares is less than zero for TORR, LE, FRED, or SOEY, 

53 Invalid Stat Op 
Can be caused by any of the following: 

* The variable list length is greater than the number of variables for HOO or DROP. 


* The sample size is zero for DRGF, LR, PRED, or SDE, 





¢ The sample size is 1 for SOE‘. 





* A sum of squares is zero for CORFE, LE, or PRED. 

54 Erd of File 

The specified record number is greater than the last record number in the file. In a text file this 

can also occur if a line length header points beyond the end of the file. 
55 Invalid Transforts 
Generated by the TRAM SFORM statement if the desired transformation from the source file 
type to the destination file type is not allowed. 
“tte Failed 
Fife failed due to an unrecoverable error, such as insufficient memory. 









57 


58 


59 


60 


61 


62 
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File and Device Errors (57 through 65) 


Message and Condition 





File Hot Found 
The specified file does not exist. (Can be generated upon return from a subprogram if execu- 
tion of the calling program file cannot be resumed because it has been purged or 
transformed.) 

Invalid Filespec 
File specifier contains an invalid name or an invalid device specifier. The specified file resides 
in a device that is not appropriate for the attempted operation. 


Fil Exi 
* A file with the same name already exists on that device. 


¢ F:LIF specified an external file which cannot be copied into main memory for execution 
due to a duplicate filename. 


e COPY or TEFIHSFORM cannot operate on system file work file or keys be 


cause HOFEKFILE or KEY already exists on the specified device. 


t 


se 





Illegal Access 
Either an attempt to alter, purge, or declare private a file that resides in ROM, or an attempt 
to FOEE into a restricted part of memory. 


File Froatect 
* Attempt to purge, alter, or declare private a file that is secure. 


* Privacy violation. Attempt to alter a private file or to access such a file through |. TST, 
FETCH, MERGE, FEEE#, or ALITO. A private file may only be executed, purged, or 
copied from an external medium into memory. 

Attempt to copy into the HP-71 a private file of unrecognized type. 


KE‘ attempted when system i == file is secured. 


° CEF 
File Open 
Attempt to open more than 64 files or attempt to open a file that is already open. Can be 


generated, for example, by attempting to execute FH: &H  # to open a file to a channel 
number when that file is already open to another channel number. 








(Continued on next page.) 
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File and Device Errors (continued) 







Message and Condition 








File 
* Specified file is not of appropriate type for the operation. 


mvalid Tiere 













* Attempt to execute CONT or FETCH, or to edit a line when the current file type is not 


BASIC. 
Attempt to run a file that is not BASIC or BINARY in type. 
* Copying to a card when the source file type is not recognized by the operating system. 







* Copying from a card when the source file type is not recognized by the operating system 
and is not within the standard file type range. 


Hot Fes 













Specified device cannot-be found. 





* Attempt to either free a port that does not contain main RAM or to claim a port that is 
not an independent RAM. 


* Attempt to create a file on an unspecified port when no independent RAM with enough 
memory is available. 


65 Line Too Lara 
* Attempt to display a line that exceeds 95 characters. 
* A line exceeds 120 characters. (Occurs as a TFA 








“CRF warning.) 






* Attempt to enter a statement having an internal representation exceeding 127 bytes. 






* in CALC mode, either the expression being entered has more than 95 characters or there 
is no memory available. 
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Card Reader Errors (continued) 


Message and Condition 


and there- 
fore cannot be written on. 


Hot This File 
The computer has attempted to read a track which is not in the same file as other tracks 
already read. 


Werifu Sl 
. ‘The eae ae to verify the card against the data which was written to it. 
Unkrour Card 

The computer does not recognize the card format. 
MoE rror 
¢ A wait of more than 7.5 seconds after the Fi 1 message has occurred. 
¢ Checksum error in card header or data field. 
¢ Hardware data error. 
Too Fast 

Card pulled too fast. 

cid 


‘Card pulled too slowly. 


| operation the name on the card does not match the name specified in the 
*’ command. 
Pe E 
During a ti! E operation the source file is larger than 65535 bytes. 
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Syntax Errors (75 through 88) 


Message and Condition 


Missing keyword; incorrect (or missing) characters in a statement. 
Valid line number or statement label not given for one of the following: 


file specifier 





=F ORM: A syntax error occurred during the transformation (accompanied by a 
warning message). 


Ci 
Mandatory expressions not entered in (!! 





‘i: More than one subscript in a string array. 


+r PS 





F statement. 





Array variable in FR THT, GOISF, STAT, REAL, SHORT, INTEGER, 01M. 
Dummy array variable in =J& parameter list. 

i e Esy ed 

Missing closing quote in IMFUT and Di 








* Extra characters at the end of an otherwise legal statement. 
Statement followed by @ when not allowed. 
Fri: More than 14 parameters specified in parameter list. 


Statement not programmable. 
Statement not keyboard executable. 


+ 


Statement not legal in an IF construct. 


(Continued on next page.) 





80 


81 


82 


83 


84 


85 











Errors, Warnings, and System Messages 391 


Syntax Errors (continued) 


Message and Condition 








® Syntax error in an expression. 
* Assignment with type mismatch (string on one side, numeric on other). 





* Quoted label declaration without a closing quote. (Statement interpreted as an implied 
=) 


¢ File command interpreted as an unquoted label declaration due to no spaces; for exam- 
ple: i 8 where is interpreted as a label declaration, and 
the computer interprets as an implied [5 =F statement. 


m 















Improper input is entered for an expected parameter. 


® Line number expected in [. p E and 










¢ Invalid keyword in 
* Invalid parameter in =1/£ parameter list. 











No input received for expected parameter: 


and 





* Line number expected in |. 











® Missing keyword in or statement. 





® Missing parameter in parameter list. 





‘ime 


Either an array variable has been specified where a simple variable is required, or a variable of 


the wrong data type has been specified. 





After single-step in CALC mode, an operator has been entered that has a higher precedence 
than the operator that was executed by the last single-step operation. 





In CALC mode: 


* A system typing aid begins with a space. Does not apply to user-defined typing aids. 


* User-defined key that is an immediate execute key definition instruction (specified 
with : when defining). 


(Continued on next page.) 
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Syntax Errors (continued) 


ee Message and Condition 





86 Operand Expected 
In CALC mode an operator is input when an operand is required. 
87 Operator Expected 






In CALC mode an operand is input when an operator is required. 





88 TFHM WRH Lann: message 

The syntax error message occurred on source file line nnn during execution of TEAHS 
FORM. This warning condition is reported during the transformation, but does not halt 
execution. 







Card Reader Messages (89 through 97) 


Message and Condition 


Fiuull nannoiaf mmm 
Prompt for all write and verify pulls, and for the second and any subsequent pulls needed to 
read a file. 
Full Card 
Prompt for first read pull, and for CAT, FROQTECT, and UWFROTECT. 

91 Wet: Align then EHOLH 

Prompt for write (ZOF* TO CARE) operation. 
92 Wig: Align then EHOLH 

Prompt for write-verify operation. 
93 Read: Align then EHOLH 


Message 
Number 


89 






















Prompt for read (I701F'* CAED) operation. 
94 Frot: Align then EHOLN 

Prompt for FRGTECT operation. 
95 ners: Align then EHOLN 

Prompt for WHFEGTECT operation. 
96 (at: Align then ENOLH 






Prompt for CAT CARD operation. 





97 Trk ann Dore 
After verifying or reading each track. 
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HP-71 Exception Flag Summary 


The following summarizes the conditions under which the HP-71 sets any of the five exception flags. 


IVL (Invalid Operation) 


The IVL exception (sets flag —8) occurs when an operand has the appropriate data type, but its value 
is a signaling NaN and/or is invalid for the operation to be performed. 


DVZ (Division By Zero) 


The DVZ exception (sets flag —7) occurs when a finite operand produces an exact infinite result 
(+Inf or —Inf). The actual result depends on the T= AF setting. 








OVF (Overflow) 


The OVF exception (sets flag —6) occurs when the magnitude of a result is too large to fit into its 
destination format. 


UNF (Underflow) 


The UNF exception occurs when the magnitude of a nonzero result is less than 1E—499. If TRAF 
CUHF® x 2, the underflow exception flag (flag —5) is set whenever the underflow exception occurs. 
Otherwise, the HP-71 sets this flag only if the underflow exception occurs and the result cannot be 
exactly represented in the destination’s denormalized format. 


INX (Inexact Result) 


The INX exception (sets flag —4) occurs when a result may be inexact. If the HP-71 does not set the 
inexact result flag, the result is exact. For several functions (+, -, #, “, SG/F, and FEC), the flag is set 
only if the result is inexact. However, for some compound functions like “ and the statistics functions, 
the computer sometimes sets the flag for results that are actually exact. 





HP-71 Keyword Index and Summary 


Some keywords appear in more than one category. 


mee [ee 


Program Entry/Editing 
AUTO 26 
DELETE 77 
EDIT 91 
FETCH 

LIST 

HAME 

PLIST 

PRIVATE 

REM (1) 


REHUMBER 
SECURE 
TRAMS FORT 
UM SECURE 


Program Execution 
CALL 31 
CHAIH 42 


LOH T 52 
RL 


Numbers lines automatically. 

Deletes program line(s) from current file. 

Assigns “current file’ status to specified file. 

Displays any line of current program. 

Displays listing of specified lines in a file. . 

Names the work file. 

Prints listing of specified lines in a file. 

Limits access to file and restricts changes in its protection. 


Enables entry of comments in program lines for program 
documentation. 


Renumbers lines in current file. 

Protects file from being altered or purged. 
Transforms BASIC file to TEXT file, or reverse. 
Clears file access restriction set by SECURE. 
Appends a statement in a multiple-statement line. 


Transfers program execution to subprogram. 


Purges current file, copies specified file into main RAM, and exe- 
cutes that file. 


Continues execution of suspended program. 
Executes a BASIC or binary program. 
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Program Control 























BYE 30 Turns computer off. 

CALL 31 Transfers program execution to subprogram. 

CHAIH 42 Purges current file, copies specified file into main RAM, and exe- 
cutes that file. 

COEF FH 67 Indicates beginning of user-defined function definition. 

EWO 93 Terminates a subprogram, user-defined function, or program. 

EHD OEF 94 Causes normal return from a multiple-statement user-defined 
function. 

EHO SUB 94 Causes normal return from subprogram invoked by CALL 
statement. 

FH 116 Transfers program execution to specified user-defined function. 

FOR... HEaT 118 Defines loop that is repeated until loop counter exceeds specified 
value. 

GOSUE 129 Transfers program execution to subroutine. 

GoTo 131 Transfers program execution to specified statement. 

IF...THEH...ELSE 134 Provides conditional execution. 

OFF 195 Turns computer off. 

OFF ERROR 195 Disables any previous OH ERROR statement. 

OFF TIMER 195 Deactivates corresponding OH TIMER # statement. 

OH ERROR GCOSUE 197 Executes specified subroutine when an error occurs. 

OH ERROR GOTO 197 Executes specified branch when an error occurs. 

OM TIMER # 201 Interrupts program at specified time and causes specified branching 
to occur. 

OW... GOSUB 199 Transfers program execution to selected subroutine. 

OH...GoOTO 199 Transfers program execution to selected statement or line. 

OH... RESTORE 199 Selects which LIHTA statement will be used by next PEAD 
statement. 


FAUSE 208 Suspends program execution. 


FOP 215 Cancels pending return of program execution from current 
subroutine. 
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a 


RETURH 


S70F 
SUE 
WAIT 


Debugging 

COMT 

DEFAULT 

ERRL 

ERRM# 

ERRH 

ON ERROR GOSUE 
QOH ERROR GOTO 
PAUSE 

TRACE 


Storage Allocation 
CLAIM PORT 
DESTROY 

Oi 

FREE PORT 
ITHTEGER 

NEM 

OPTIOW BASE 
REAL 

SHORT 

SHOW FORT 


STAT 





Returns program execution to statement following invoking 
GOSUE,. 

Terminates a subprogram, user-defined function, or program. 
Identifies beginning of subprogram. 


Causes program execution to wait for specified number of seconds. 


Continues execution of suspended program. 


Sets math exception traps to specific values. 

Returns line number of most recent error or warning. 

Returns message text of most recent error or warning. 
Returns error number of most recent error or warning. 
Executes specified subroutine when an error occurrs. 
Executes specified branch when an error occurs. 

Suspends program execution. 

Traces program execution and variables in a running program. 


Returns independent RAM to main RAM status. 

Deletes variables and arrays from memory. 

Allocates memory for string or REAL variables and arrays. 
Switches a portion of main RAM to independent RAM status. 
Creates INTEGER variables and arrays. 

Returns number of bytes available in memory. 

Specifies subscript lower bounds for arrays. 

Creates REAL variables and arrays. 

Creates SHORT variables and arrays. 


Displays type and size of all plug-in memory devices and indepen- 
dent RAMs. 


Selects or creates a statistical array. 
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a 


Logical and Relational Operators 


AHO 
Esor 
HOT 
OF 


19 
105 
193 
206 
317 
317 
317 
317 
317 
317 
317 
317 


Arithmetic Operators 


General Math 


ABS 
CETL 


EXPOMEHT 
FACT 
FLOOR 


308 
309 
310 
311 

87 


312 
313 


10 
40 


49 
90 
108 
109 
115 


Performs logical And of its operands. 

Performs logical Exclusive Or of its operands. 

Performs logical Not of its operand. 

Performs logical Or of its operands. 

Performs Equality test on its operands. 

Performs Inequality test on its operands. 

Performs Less Than or Greater Than test on its operands. 
Performs Less Than test on its operands. 

Performs Less Than or Equal To test on its operands. 
Performs Greater Than test on its operands. 

Performs Greater Than or Equal To test on its operands. 
Performs Unordered Comparison test on its operands. 


Addition. 

Subtraction. 

Multiplication. 

Division. 

Divides one argument by another and returns integer portion of 
quotient. 

Exponentiation. 

Percent. 


Returns absolute value of its argument. 


Returns smallest integer greater than or equal to specified 
argument. 


Returns value indicating class of argument. 

Returns divide-by-zero flag number (—7). 

Returns exponent of its normalized argument. 

Returns factorial of non-negative integer argument. 
Returns greatest integer less than or equal to argument. 
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a 


FF 
INT 

IN 

IF 

TVL 

LET 

MAX 

MI 

Moo 

OPTION ROUND 
CF 
RANDOMIZE 
REQ 

RES 

PMO 

RENO 


SGH 


SIR 


Sa eT 
UH F 





Logarithmic Operations 


EXP 


ESPM1 
EXPOHEHT 
LET 

LH 

LOG 

LOGP 1 
LOGIa 


121 
154 
157 
158 
159 
168 
181 
188 
190 
204 
207 
233 
240 
247 
252 
254 


268 


273 
273 
295 


106 


107 
108 
178 
176 
176 
177 
178 


Returns fractional part of numeric value. 

Returns greatest integer less than or equal to argument. 
Returns inexact result flag number (— 4). 

Returns integer part of argument. 

Returns invalid operation flag number (—8). 

Assigns value to variable. 

Returns larger of two values. 


Returns smaller of two values. 
Returns remainder of modulo reduction. 
Selects roundoff setting. 


Returns overflow flag number (—6). 

Specifies a “seed” for the FHD function. 

Returns remainder of argument reduction. 

Returns value of most recently executed numeric expression. 
Returns remainder of division. 


Returns next real number in a pseudo-random number sequence 
and updates current seed. 


Returns —1, 0, or 1 if argument is less than zero, equal to zero, or 
greater than zero, respectively. 


Returns square root of argument. 
Alternate spelling for SF. 
Returns underflow flag number (~—5). 


Returns the number e = 2.718281828 . . . raised to power given by 
argument. 


Returns value of e#9ument —_ 4, 

Returns exponent of its normalized argument. 
Alternate spelling for LOGIa. 

Alternate spelling for LOG. 

Returns natural logarithm (base e) of argument. 
Returns In(1 + argument). 


Returns logarithm (base 10) of argument. 
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ee 


Trigonometric Operations 


ACOS 11 Returns arccosine of its argument. 

ACS 11 Alternate spelling for ACUS. 

ANGLE 20 Returns polar angle determined by (x,y) coordinate pair. 

ASTH 22 Returns arcsine of its argument. 

ASH 22 Alternate spelling for ASTH. 

ATAM 25 Returns arctangent of its argument. 

ATH 25 Alternate spelling for ATAH. 

cos 59 Returns cosine of its argument. 

CEG 73 Converts argument in radians to degrees. 

DEGREES 74 Sets unit of measure for expressing angles to degrees. 

QOPTIOW AWGLE 204 Selects unit of measure for expressing angles. 
RAC 231 Converts arguments expressed in degrees to radians. ; 
RACIAHS 232 Sets unit of measure for expressing angles to radians. 
SIN 272 Returns sine of its argument. 

TAH 284 Returns tangent of its argument. 

Statistics 

AOC 12 Adds coordinates of a data point to data set represented by sum- 


mary statistics in current statistical array. 


CLETAT 51 Clears all elements in current statistical array. 

CORR 58 Returns sample correlation coefficient between a specified pair of 
variables. 

OROF 88 Removes coordinates of a data point from the data set represented 
by summary statistics in current statistical array. 

LE 179 Specifies current linear regression model and computes intercept 
and slope for that model. 

MHEAH 183 Returns sample mean of specified variable. 

FRELH 218 Returns predicted value of dependent variable. 

SOE 259 Returns standard deviation of specified variable. 

STAT 275 Selects or creates statistical array. 

TOTAL 287 Returns total of specified variable. 
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sewer [i 


Constants 
EPS 


IHF 
MASREAL 


MIHREAL 


HAN 
FI 


Strings 


CHR $ 
LEH 
HUM 
POS 
STR 
UPRCS 
VAL 


VERE 


Input/Output 
ASSIGH # 


BEEF 
BEEP OFF 
BEEP OH 
COMTRAST 
cory 
CREATE 
CATA 
DELAY 


Returns HP-71's smallest positive, normalized number 
(1.0 E—499). 


Returns machine representation of positive infinity. 


Returns maximum positive finite number that the HP-71 can repre- 
sent (9.99999999999E499). 


Returns smallest positive number that HP-71 can represent 
(0.00000000001E — 499). 


Returns Signaling NaN. 
Returns 12-digit value representing 7. 


Concatenation operator. 

Converts numeric value into ASCII character. 

Returns length of specified string. 

Returns ASCII numeric code for first character of string. 
Returns position of given substring. 

Returns string representation of value of argument. 
Converts lowercase letters to uppercase. 


Converts a numeric expression within a string expression to a nu- 
meric value. 


Indicates versions of system ROMs and LEX files. 


Associates symbolic channel number with specified file and opens 
that file. 


Causes specified tone to sound. 

Disables beeper. 

Enables beeper. 

Adjusts display contrast. 

Copies information from source file to destination file. 
Creates a data file. 

Contains data that can be read by FEAL. 

Sets line and character scroll rates in display. 


OISe 

DISP USING 
OISPs 
EWOLTIHE 


ENG 

FIX 
GOISP 
GOISPS# 
IMAGE 
INPUT 
EEYOOWH 
Le 
LIHPUT 
LIST 
ON...RESTORE 


PLIST 
PRIMT 
PRIHT USTHG 


PREIHT 
PUT 

FH IOTH 
READ 
REAG # 
RESTORE 


RESTORE # 
Sel 


270 
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Displays numeric and string data. 
Displays items according to specified format. 
Returns string containing all readable characters in display. 


Specifies end-of-line sequence used in FRIHT and FLIST | 
statements. 


Selects engineering display format. 

Selects fixed display format. 

Sets specified dot pattern in display. 

Returns 132-character string reflecting dot pattern in display. 
Controls format of displayed and printed output. 

Enables assigning values to program variables from keyboard. 
Returns 0 or 1, depending on whether key is being pressed. 

Selects between uppercase and lowercase lock on keyboard. 
Assigns display line to string variable. 

Displays listing of specified lines in a file. 


Selects which LIHTA statement will be used by next REAL 
statement. 


Prints on print device a listing of specified lines in a file. 
Causes print list to be sent to print device. 


Causes print list to be sent to print device according to specified 
format. 


Writes data items to data file in memory. 

Enters a specified key code into key buffer. 

Defines line length of FRIHT and FLIST statements. 
Assigns values from CATA statements to variables. 
Reads data items from data file. 


Specifies which CHTA statement will be used by next FEAL 
operation. 


Sets specified file pointer to indicated record number. 
Selects scientific notation display format. 
Selects standard BASIC display format for numbers. 
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THE 82 Moves (LISP or FEIHT position ahead to specified column. 
) 219 (Refer to the DISP or PRINT keyword entry.) 
































UPRCS 298 Converts lowercase letters to uppercase. 

USER 299 Activates or deactivates user-defined key assignments. 
WIOTH 303 Defines line length for CISF and LIST statements. 
WIMOOH 305 Sets display window size and location. 





Graphics 
GOISF 124 Sets specified dot pattern in display. 
GOISRS 127 Returns a 132-character string reflecting dot pattern in display. 





File Management 
AOOR $ 13 Returns string representing hexadecimal address of specified file. 


CAT 35 Gives catalog of file information. 

CATS 38 Returns catalog information for a specified file. 

CLAIM PORT 48 Returns independent RAM to main RAM status. 

CF 55 Copies information from source file to destination file. 
TREATE 60 Creates a data file. 

EQIT 91 Assigns “current file” status to specified file. 

FREE FORT 122 Switches a portion of main RAM to independent RAM status. 
MEM 184 Returns number of bytes available in memory. 

NHERGE 186 Merges all or part of file into another file. 

HAE 191 Names system workfile. 

PRIVATE 225 Limits access to file and restricts changes in its protection. 
FROTECT 226 Write-protects one track of a magnetic card. 

FURGE Deletes file from RAM. 





REMWANE 243 Changes name of file. 


SECURE 260 Protects file from being altered or purged. 
SHOW FORT 271 Displays type and size of all plug-in memory devices and indepen- 
dent RAMs. 






TRAM SFORM Transforms BASIC files into TEXT files, or the reverse. 
UHPROTECT 296 Removes the write-protection from one track of a magnetic card. 
UN SECURE 297 Clears file access restriction set by SECURE. 
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Time and Date 

ACWJIABS 14 Performs an absolute adjust on system clock. 

ADIUST 15 Changes clock time and specifies clock speed correction. 

AF 17 Returns current value of clock accuracy factor and gives option of 






























setting new adjustment factor. 
DATE 65 Returns current clock date as an integer (YYDDD). 
DATES 66 Returns current clock date in year/month/day format. 
EXACT 103 Calibrates system clock and tells HP-71 that time currently stored is 


the correct time. 
RESET CLOCK 248 Nullifies effect of executing EXACT. 


SETOATE 262 Sets date on system clock. 

SETTIME 264 Sets time on system clock. 

TIME 285 Returns time of day in seconds since midnight. 
TINE 286 Returns time of day in HH :MM :SS format. 





System Settings and Flags 


CFLAG 41 Clears specified user and/or system flags. 

DEFAULT 72 Sets math exception traps to specific values. 

DEGREES 74 Selects degrees as unit of measure for angles. 

DELAY 75 Sets line and character scroll rates in display. 

Cie 90 Returns divide-by-zero flag number (—7). 

FLAG 114 Returns current value (O or 1) of specified flag, and optionally se- 


lects new flag setting. 
IH 157 Returns inexact result flag number (— 4). 
IVb 159 Returns invalid operation flag number (—8). 


QOPTIOHW AHGLE 204 Specifies unit of measure for expressing angles. 

OPTION BASE 204 Specifies subscript lower bounds for arrays. 

OPTION ROUHO 204 Specifies round-off setting. 

OF 207 Returns overflow flag number (—6). 

RAQIAHS 232 Selects radians as unit of measure for angles. 

RESET 248 Resets user and system flags and traps to their system default 
settings. 

SFLAG 267 Sets specified user and/or system flags. 
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Description 





Keyword 


293 Returns trap for specified flag number and optionally selects new 
trap setting. 


295 Returns underflow flag number (—5). 


Customization, Keyboard, and Display Control 
















ADRS 13 Returns string representing hexadecimal address of specified file. 

CHAR SET 43 Specifies alternate character set in ASCII! code range of 128 
through 255. 

CHARSET£ 46 Returns string representing current alternate character set. 

COW TRAST 54 Adjusts display contrast. 

DEF KEY 69 Assigns character string to specified key. 

DELAY 75 Sets line and character scroll rates in display. 

OTHS 89 Converts decimal number to string representing its five-digit hexa- 
decimal value. 

FETCH KEY 111 Displays specified key assignment for editing. 

FIX 112 Sets fixed display format and number of fractional digits to be 
displayed. 

HT 133 Converts string argument representing hexadecimal number to deci- 
mal number. 

IMAGE 136 Controls format of displayed and printed output. 

KEY 69 Assigns character string to specified key. 

REVS 160 Returns and deletes oldest key or keystroke combination from key- 
board buffer. 

EEYOEF $ 162 Returns redefined value of a key. 

EEVOOMH 164 Returns or 1, depending on whether key is being pressed. 

Li 166 Selects between uppercase and lowercase lock on keyboard. 

LOCE 175 Sets password. Causes HP-71 to prompt for that password the 


next time computer is turned on. 


FEER SF 209 Returns contents of specified section of memory. 
1 PORE 213 Writes to memory at specified hexadecimal address. 
FUT 229 Enters a specified key code into key buffer. 
STARTUP 274 Defines command string to be executed when HP-71 is turned on. 
USER 299 Activates or deactivates user-defined key assignments. 


| HIMOOM 305 Sets display window size and location. 
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Page numbers in bold type indicate primary references; page numbers in standard type indicate 
secondary references. Because the manual mentions some indexed topics only in a secondary sense, 
such topics are listed without any primary references. Also, because the HP-71 keywords are listed 
alphabetically in the Keyword Dictionary, main keyword entries are not indexed. 


A 





Abort, transformation, 292 
Absolute value, 10 
Access 

random, 224, 237 

sequential, 224, 237 
Accuracy, 7, 284 
Accuracy factor, default, 329 
Actual parameter, 68, 116 
Addition, 308 
Address, hexadecimal, 89, 133, 209, 213 
Adjust clock, 15 
Adjust clock, absolute, 14 
Adjustment 

factor, 17, 104 

interval, 17 

period, clock, 103-104 
Allocating memory, 79, 155, 156 
Altering a file, protection, 260 
Alternate character set, 43-45, 46, 323-326, 330 

deactivating, 45 

memory, 45 
Ampersand, 307 
Angle, unit of measure, 204-205 
Angular setting, 11, 20, 22, 25, 59 
Angular setting default, 74 
Annunciator 

flags, 319 

RAD, 205, 232 

SUSP, 110, 256, 53 
ANSI 

BASIC Standard, 252 

minimal BASIC, 83 

minimal BASIC Standard X3J2, 277, 280 
Antilogarithm, 106, 107 


Argument 

normalized, 108 

pairs, invalid, 20 
Array, 155, 156 

bounds, 316 

creating, 169 

deleting, 78 

integer, 155-156 

lower bounds, 204, 205 

pass by reference, 32 

real, 79-80, 238-239 

real string, 80 

redimensioning, 80, 156, 239 

SHORT, 269-270 

statistical, 12, 88, 218, 259, 275, 276, 287, 334- 

337 
statistical default OF TIOH BASE setting, 275, 
276 

string, 333 

variable, 315, 316 

variable, parameter passing, 282 
ASCII, 61, 326 

character, 47 

character code, 43, 328 

string, 237 
Assigning variables, 151-153 
Assignment 

statement, 168-170 

variable, 234-235 
At (@) symbol, 274 
At (@) symbol, with IMAGE, 136 
(ATTN], during input, 153 
Automatic 

line numbering, 26 

startup, 274 

timeout, 153 


B 





Base 10, logarithm, 178 
BASIC file, 225 
BASIC file, memory requirements, 331 
BASIC-to-TEXT transformation, 290 
Batteries, 329 
BEEP, default setting, 330 
BIN file, 225 
BIN file, memory requirements, 332 
Binary 
codes, 323-326 
operator, 206, 308-313 
program, 255 
representation, display, 124-126 
subprogram, 283 
Bit pattern, 127, 124-126 
Bit pattern, locking, 126 
Blank, 8 
leading, 63, 82 
trailing, 63, 82 
use in inputs, 9 
Branch, 197 
on error, 197 
timer, 201-203 
tracing, 288 
unconditional, 131, 135 
Buffer 
display, 124 
input, 153 
key, 160, 229 
B‘'E, operation with timer, 202 


C 





(CALC), during input, 153 
mode, 247, 274 
mode, assignment statement, 168 
Calendar date, 262-263 
Calibrate, clock, 15, 103-104 
Call 
function, 235 
subroutine, 197 
Calling program, 63, 233 
Card 
copying, 226 
file, private, 56 
magnetic, 226, 296 
protection, 296 
reader, 36, 123, 226 
verifying 56 
Carriage return, 138, 220 
Carriage return/line feed, 96. See also CR/LF. 
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Case lock, 166 
Catalog 
listing, 260 
purged, 42 
string form, 38 
unsecured private file, 225 
Channel, 23, 24, 32, 33 
Channel number, 224, 236, 237, 250, 315 
Character 
code, 124, 125, 322-326 
rate, 75 
readable, 86 
set, 322-326 
set, alternate, 43-45, 46, 330 
set, standard, 43 
width, 44 
Characters, control, 326-327 
CHR#, 125, 127, 1389, 145, 164, 194, 
with character codes, 322-326 
with escape sequence, 328 
CLASS, 342 
Classes of numbers, 342 
Clearing a flag, 114 
Clock, 103, 248, 262-266 
absolute adjust, 14 
adjustment 
calibrate, 15 
default settings, 329 
factor, 17, 103-104 
interval, 17 
resolution, 16, 266 
setting, 103 
speed, 14, 15 
stored correction, 15 
time, 14 
Codes, binary, 323-326 
Codes, hexadecimal, 323-326 
Columns, display, 44 
Command stack, during input, 153 
Command stack memory requirements, 330 
Commands, 5 
Comments, 242 
Comparison table, math exceptions, 344 
Comparisons, unordered (‘), 343 
Concatenation, 30, 34, 129, 1380, 196, 274 
IMAGE, 136 
operator, 5 
statements, 306 
string, 307 
Conditional execution, 134-135 
Congruential method, linear, 254 
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Constants, memory requirements, 330 

Continuing a program, 208 

Control characters, 326-327. See also (CTRL). 

Conversion 
degrees to radians, 231 
numeric-to-string, 280 
string-to-numeric, 300 

Coordinate pair, 20 

Coordinates, of data point, 12 

Copying a card, 226 

Counter, loop, 118, 119 

CR/LF, 96, 220 

(CTRL], 328 


keystrokes, 323. See also Control characters. 


Current file, 91, 227, 228, 256 
Current file, assigning, 36 
Customizing the keyboard, 69 


D 





Data 

assignments, 234-235 

file, 60, 61, 223, 224, 236, 237, 250 

file channels, memory requirements, 330 

memory requirements, 331 

point, 334, 336 

pointer, 199, 200, 237 

reading, 234-237, 249 

type, changing, 239 
Date, setting, 262-263 
Deactivating timers, 196 
Deassigning keys, 70 
Debugging, 52 
Decompile, TEXT/LIF1 file, 290 
CEFAULT, math exceptions, 339 
OEFAULT EXTEND, 341 
Default 

angular setting, 74 

environment, 314 

settings, 329-330 

value, math exceptions, 339-343 
Degrees setting, 11 
Degrees-to-radians conversion, 231 
Deleting 

file, 227-228 

line number, 27 

variables and arrays, 78 


Delimiter, 9, 143, 171 
field, 142 
IMAGE, 146, 147 
Denormalized number, 98, 189, 257, 277, 317, 341- 
342 
Dependent variable, 179, 180, 218 
Destination file, 55-57, 187, 225, 290 
Deviation, standard, 259 
Device chain, 123 
Device number, 48 
Direct execute key, 162, 256 
Direct execute user-defined key, during input, 153 
Direct execution, 69, 70, 111, 
Disp, implied, 135 
Display, 124-126, 127, 128 
buffer, 124 
character set, 322-326 
columns, 44 
escape code sequences, 328 
format, 277-278 
format control, 136-149 
formatting, 83, 85 
line length, 303 
list, 84 
locking a bit pattern, 126 
rounding, 280 
setting, 112, 257 
setting, changing, 278 
setting, default, 329 
string, 86 
window, 305 
zones, 82 
Division-by-zero, 338, 393 
Division-by-zero flag, 108 
Dot pattern, 124-126, 127 
Dot pattern display, 305 
Duplicate names, subprograms, 33 
Duration, 28, 29 
OVE, 338 
DVZ, 108, 150, 393 


E 
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e, 106, 107, 176 
Editing, 53, 91, 131 
End-of-file mark, 224 
End-of-line sequence, 96, 138 
EWOLIHWE, default setting, 329 
Endline string, 96 
Engineering display format, 97-98, 281 
Environment, 33, 34, 256, 314 
global, 33 
local, 42, 228, 92 
Environment, maintaining, 314 
Environment, user-defined function, 117 
EOL, 152 
(ERRM], during input, 153 
Error 
clock precision, 103 
correction, accumulated, 16 
during input, 153 
during transformation, 291-292 
handling, in programs, 197-198 
IMAGE syntax, 143 
in subprogram, 100 
line number, finding, 100 
message, 378-392 
message, defined, 378 
nonBASIC program, 100 
number, 102 
reporting, 195 
rounding, 339 
rounding, string, 101 
program, 197 
Escape code sequences, display, 328 
European digit separator, 141 
European radix, 139, 141, 144 
Exact flag, 103 
Exception 
flag, 72 
flag, DVZ, 108 
flag, DVZ, summary, 393 
math, comparison table, 344 
traps, 72 
Exclusive or, 105 
Execute only string, 172 
Execution, 
suspend, 117, 130 
transferring, 251 
Exponent 


OISF or FRIHT USIHG maximum, 148 


range, 182 
Exponentiation, 312 
Extended range computations, 108 





Field delimiter, 142 
File 


access restriction, 260, 297 
alter or purge protection, 260 
automatic purge, during transformation, 292 
backup, 292 

BASIC, 225 

BIN, 225 

creating, 91-92 

current, 36, 91, 227, 228, 256 
DATA, 224, 237, 250 

data, 223, 236 

default condition, 329 

deleting, 22'7-228 

destination, 55-57, 187, 225, 290 
header, 13, 77 

independent of main RAM, 122 
KEY, 243 

key assignment, 297 

keys, 212, 228, 299 

LEX, 57, 292, 301 

LIF1, 37, 57 

list, 173-174 

listing, 225 

listing on printer, 211-212 
memory requirements, 331 
merging, 186-187 

pointer, 110 

private, 209, 213, 225, 260 
private secured, 225 

protection, 36, 260 

purging. See deleting. 
renaming, 243-244 

reset, 48 

SDATA, 224, 237, 250 

source, 55-57, 187, 290 

TEXT, 224, 237, 250 

type unrecognized, 39 
unrecoverable, during transformation, 292 
unsecured, 225, 228, 297 
workfile, 191 


Final value, loop, 119 
Fixed format, 112 
Fixed-precision display format, 280 
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Flag, 248 
—5, 295 
—10, 205 
—15, 166 
—46, 248 
clearing, 114 
default settings, 329 
divide-by-zero, 108, 90 
Exact, 103 
exception summary, 393 
inexact result, 104, 157, 190 
invalid operation, 159 
INX, 252 
math exception, 338 
numbers 
overflow (—6), 207 
set, clear, test, save, 114 
setting, 114, 267 
subprogram, 314 
system, 319 
underflow exception (—5), 189 
volume, 28 
Floating specifiers, 147 
FOR...HET loops, memory requirements, 332 
Form feed, 138 
Formal parameter, 33, 67, 68, 116 
Format 
control, display and printer, 136-149 
display, 83, 85, 277-278 
engineering, 97-98 
fixed, 112 
image, 221 
Keyword Dictionary, 6-7 
scientific, 257-258 
string, 85, 138, 222 
Fractional part, 121 
Frequency, 28, 29 
Function, call, 235 
Function references, memory requirements, 331 


G 





Global 
angular settings, 74 
declaration, 233 
effect, settings, 205 
environment, 33, 314 
timer, 203 
tracing, 288 
variables, 68 
Glossary, using, 9 
GOTO, implied, 135 
Gradual underflow, 341 
Graphics, display, 124-128 


H-I 





Hexadecimal 
address, 13, 209, 213 
codes, 323-326 
conversion, 89 
to decimal conversion, 133 


HP 82400A card reader, 296. See also Card reader. 


HP Logical Interchange Format (See LIF1.) 
HP-41, 61 
HP-75, 61, 290 
IEEE 
Floating Point Standard, 241 
Math Exceptions, 338-345 
remainder function, 241 
traps, 149 
IMAGE, location in program, 137 
Image format, 221 
Immediate execution, 70, 111 
Implied 
OISF, 135 
GOTO, 135 
negative, 147 
In-place transformation, 290, 292 
Independent RAM, 122 
Independent variable, 179, 180, 218 
Inexact, 157 
flag, 104, 190 
result, 339, 393 
INF, 169 
Inf, 280, 300, 310, 311, 312, 313, 341 
in IMAGE, 148-149 
loop control value, 119 
subtraction, 309 
Infinite loop, 119, 198 
Infinity, 341 
Infinity, positive, 150 
Initial value, loop, 119 
Initialize, 155, 238, 239, 269 
data, signalling NaN, 341 
loop, 119 
numeric array, 155 
Input, line, 171-172 
Insufficient Memory, 122 
INTEGER, 169 
INTEGER variable, 247 
Integer, greatest, 115 
Integer, part, 158 
Intercept, 179, 180 
Interchanging files, 289 


Invalid operation, 338, 393 
Invalid operation flag, 159 
Inverse transformation, 292 
IH, 339 

IH flag, 190, 252 

IML, 338, 393 

IVL trap value, loop control, 119 


K 





KRY file, 211, 243 
KEY file, memory requirements, 331 
Key 
assignment, 70, 111, 243 
assignment file, 297 
buffer, 160, 229 
code, 229 
deassigning, 70 
definition, 162 
direct execute, 162, 256 
file, list, 173, 174 
nonterminating, 162 
renaming, 243 
terminating, 162 
test, 164, 165 
Keyboard, concatenation, 196 
Keyboard control, 129 
keys, 297 
keys file, 70, 186, 212, 228, 299 
Keystroke combinations, 319-322 
Keyword 
combined entry, 5 
defined, 5 
dictionary, how to use, 5 
dictionary format, 6-7 
finding entries, 5 
index, using, 9 
middle, 5 
operators, 5 
plug-in-module, 37 
related, 6 
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LCD, 305 
Leading blank, 63 
Length of string expression, 167 
LEX file, 57, 292, 301 
LEX file memory requirements, 332 
LIF1, 57, 60, 61 
LIF1 file, 37, 290 
Limits of numerical representation, 318 
Line 
feed, 138, 220 
input, 171-172 
length, 303 
length, maximum, during transformation, 291 
length, printer, 230 
renumbering, 187 
Line number, 131 
automatic, 26 
deleting, 27 
Line rate, 75 
Lines, renumbering, 245-246 
Linear congruential method, 254 
Linear regression, 179, 180 
Linear regression, simple, 337 
List display, 84 
List halt, 174 
Listing file, 225 
Listing on a printer, 211-212 
Local environment, 33, 34, 42, 228 
Lock, case, 166 
Locking a bit pattern, 126 
Locking the HP-71, 175 
Logarithm, natural, 176, 177 
Logarithm base 10, 178 
Logical NOT, 193 
Logically false, 19 
Loop, 118, 119, 122, 127, 128 
Loop, infinite, 198 
Loss of memory, 213 
Lower bounds, subscript, 204, 205 
Lowercase, 8, 166, 298 
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M 





Machine-representable numbers, 50 


Magnetic card, 36, 226, 296. See also Card reader. 


file size, 37 
HP-75 file, 37 
overhead, 37 
track, 36 
Main 
environment, 314 
program, variables, 130 
RAM, 122 
Matched sample, 334 
Math exception, 338-345 
comparison table, 344 
CFLAG, 338 
flag, 267 
traps, 72 
Math operators, 5 
Math trap, 248 
Maximum real number, 182 
Maximum value, 181 
Mean, sample, 183 
Memory 184-185 
allocating, 79, 155, 156 
allocating, suspended program, 208 
conserving, 306, 333 
contents, 209 
DATA files, 224 
external, 184 
insufficient during transformation, 292 
loss, 213, 329 
reclaiming, 78 
releasing, 93, 94, 95 
reset, 100, 101, 316, 329 
reset, flags, 319 
SDATA files, 224 
system requirements, 330-332 
type, 271 
use, user-defined function, 94 
writing to, 213 
Memory Lost, 122 
Memory Lost condition, 329 
Merging files, 186-187 
Message string, error or warning, 101 
Minimum of two values, 188 
Minimum real number, 189 
Minus, 309 
Mode 
CALC, 274 
radians, 232 
SCI, 257-258 


Modulo, 190, 272, 284, 304 
Multiple-statement function definition, 94 
Multiple-statement line, 137 
Multiplication, 310 
Multistatement line, 306 

restriction, 306 

string, 274 

string or command, 274 


N 





NaN, 150, 192, 280, 300, 340-341, 343 
in IMAGE, 148-149 
loop control value, 119 
sign, 309 
Natural logarithm, 176 
Negative, implied, 147 
Nested parentheses, 138 
Nesting, IF... THEH...ELSE, 135 
NonBASIC program, error, 100 
Nonprogrammable function, 271 
Nonprogrammable statement, 5, 110, 111, 122, 26, 
48, 52, 77, 91 
Nonterminating key, 162 
Normalized 
argument, 108 
number, 98, 257, 342 
number, smallest positive, 99 
Not-a-number, 340-341. See also NaN. 
Notation, scientific, 257 
Null, 80, 247, 274 
argument, 175 
string, 101, 133, 160, 194, 274 
string, KE‘'DOWMH parameter, 165 
unquoted, 152 
Number 
classes, 342 
denormalized, 189 
machine-representable, 50 
Numeric 
expression, 318 
precision, 80 
settings, default, 329 
variable, creating, 169 
variable, REAL, 80, 239 
variable, SHORT, 270 
Numeric-to-string conversion, 280 


0 





Off, 30 
Off, operation with timer, 202 
On, continuous, default, 330 
Opening a file, 60 
Operator 
binary, 308-313 
concatenation, 5 
descriptions, location 5 
math, 5 
memory requirements, 331 
precedence, 105, 317 
relational, 5 
OFTIOH BASE setting, 80 
Out-of-place transformation, 290 
Output field, reusing, 142 
Output list, 138, 142 
Overflow, 108, 207, 338-339, 393 
Overflow, factorial, 109 
Overflow, IMAGE, 142 
Overflow, string, 169 
Overflow, threshold, 182, 317, 318 
OVF, 150, 338-339, 393 
OVF, trap, 142, 148 


P 


Padded file size, 37 
Parameter 
actual, 116 
formal, 33, 116 
passing, 31, 68, 116 
passing, subprograms, 282-283 
Pass by reference, 32 
Pass by value, 32 
Passing parameters, 31, 32 
Passing parameters by value, 68 
Password, 175 
Password, default, 329 
FEW, 145 
Pending return, 215 
Percent, 313 
Pi (x), accuracy, 272 
Pi (x), number of digits, 59 
Piston program, 127, 128 
Pointer 
data, 199, 200, 235, 237 
file, 110, 122, 250 
program, 200 
Polar angle, 20 
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Port, 122-123, 184, 271 
device number, 122, 123 
HPIL, 123 
search, 92 
Postfix form, 333 
Precedence, operators, 105, 317 
Precision, numeric, 80 
Predicted value, 218 
Print list, 221 
Printer 
format control, 136-149 
listing a file, 211-212 
width setting, 212 
Private, 36 
card file, 56 
file, 209, 213, 225, 260 
file, secured, 225 
Program 
binary, 255 
calling, 233 
debugging, 52 
editing, 53, 91 
entering, 91 
error handling, 197-198 
interruption, 256 
line, multiple-statement, 137 
scope, 117, 131 
suspend, 42, 52, 92, 93, 208, 279, 339 
suspend timer operation, 202 
transfer execution, 199, 200, 201-203 
Programming, default conditons, 330 
Prompt, display message, 152 
Prompt, input (7), 152 
Protected field, display, 305 
Protection, file, 36, 260 
Pseudo-random number, 254 
Purging a file, protection, 260 


Q-R 
Question mark (‘*) symbol, input, 152 
Question mark (#) symbol, unordered comparisons, 
343 
Quiet NaN, 341, 342 
Quoted strings, 6 
Quotes, 6 
Quotes, matching, 6 
RAD annunciator, 74, 205, 232 
Radians mode, 232 
Radians setting, 11, 59 
Radix, 141, 144, 146, 147 
European, 139 
IEEE proposal, 338 
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RAM 
independent, 122 
main, 122, 184 
plug-in, memory requirements, 332 
removing, 122 


Random 
access, 224, 237 
number, 254 


number seed, 233 
Range, exponent, 182 
Range of numbers, diagram, 318 
Read list, 237 
Readable character, 86 
Real number, maximum, 182 
REAL numeric variables, 80, 190 
Record, 61, 224 
Record number, 224, 237, 250 
Recoverable error, during transformation, 291 
Recursion, 68 
Recursive calculation, statistics, 336 
Redimensioning, 79, 288 
Redimensioning an array, 156 
Reduction, 240-241 
Reference, parameter passing, 282 
Regression, linear, 179, 180 
Reinitialize, 80, 156, 239, 270 
Reinitialize, numeric or array variable, 156 
Related keywords, 6 
Relational operators, 5 
Relative errors, logarithms, 177 
Releasing variables and memory, 93 
REM, 137 
Remainder, 252 
Remainder function, IEEE, 241 
Remark, 63, 242 
Remark with IMAGE, 136 
Renumbering lines, 187, 245-246 
Replication, 138, 144 
Representable numbers, 317-318 
Reset, 175, 305 

level three, 103 

memory, 100, 101, 329 
Restoring data pointer, 200 
Return 

from function, 94 

from subprogram, 94 

pending, 215 
Reverse transformation, warning, 292 
ROM 

plug-in, 145 

plug-in memory requirments, 332 

system, 301 


Rounding, 341 
error, 339 
INTEGER variable, 169 
SHORT variable, 169 1 
Roundoff setting, 204, 205 
[RUN], 256 
during input, 153 
Run-time error, 102 


S 


Sample, 334 
correlation, 58 
mean, 183 
standard deviation, 259 
SCI mode, 257-258 
Scientific 
notation, 257 
display format, 281 
format, 257-258 
Scope, program, 117, 131 
Scrolling, 75, 127, 128, 305 
SDATA file, 60, 61, 224, 237, 250 
SDATA file, memory requirements, 332 
Search order, subprograms, 33 
Secure, 36 
Secured private file, 225 
Seed, random number, 233, 254 
Sequential access, 224, 237 
Service, 301 
Setting, display, 112 
Setting a flag, 114 
Shifted keys, f, 9, 160 
SHORT, 169 
numeric variables, 247, 270 
precision, 269-270 
Sign, floating, 141 
Sign of zero, 342 
Signalling NaN, 192, 341, 342 ‘ 
Significance errors, 335 
Simple variable, 315, 316 | 
Single-step execution, 131 
Slope, 179, 180 
Smallest integer, 40 
Source file, 55-57, 187, 290 
Space, ignored in IMAGE, 143 
Specifier, port, 122 
(SsT], during input, 153 
Standard deviation, 259 
Standard display format 277-278, 280 
Start line number, 26 





STHETUF string, default, 330 
Statement 
concatenation, 306 
joining, 306 
suspend, 131 
Statistical array, 259, 275, 276, 287, 334-337 
default CF TIGH BASE setting, 275, 276 
specifying, 335 
Statistics, 88 
AOO, 336 
CLSTAT, 336 
OROF, 336 
linear regression, 337 
LR, 337 
math exceptions, 339 
STAT, 335 
STEF, 118, 119 
String 
array, 333 
assignments, 168-170 
catalog, 38 
concatenation, 307 
execute only, 172 
expression, length, 167 
multistatement, 274 
null, 101 
overflow, 169 
time, 286 
variable, creating, 169 
variable length, 81 
String-to-numeric conversion, 300 
Subprogram, 31, 32, 33, 34, 208, 233, 279, 282-283, 
288, 315 
calls, memory requirements, 332 
DATA statements, 63 
data reading, 249 
duplicate names, 33 
ending, 94 
environment, 314 
error, 100, 198 
parameter list, 32 
passing parameters, 31, 32, 116, 282-283 
recursion, 32 
search order, 33 
suspended, 34, 95 
terminating, 95 
timer operation, 203 
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Subroutine, 129, 130, 200, 208, 215 
call, 197 
call, memory requirements, 332 
on error, 197 
return, 251 
suspended execution, 130 
timer, 202 
Subscript, 155, 238 
Subscript, array, 269, 316 
Subscript, array, lower bounds, 204, 205 
Substring, 216, 333 
Substring, references, memory requirements, 331 
SUSP annunciator, 53, 92, 110, 131, 256 
Suspend 
program, 93, 208 
statement, 131 
subprogram, 34, 95 
user-defined function, 94 
Suspended 
execution, single-step, 131 
program, 42, 52, 256, 279 
program, timer operation, 202 
Symbolic channel number, 23 
Symbols, special, 346 
Syntax 
diagrams, 6 
diagrams, how to read, 8 
error, 102 
error, IMAGE, 143 
System 
catalog, 33, 262-266 
configuration, change, 122 
flag, 114, 319 
messages, 378, 382-383 


T 


THE, 82, 83, 220, 230, 304 

Terminate program, subprogram, or user-defined 
function, 93 

Terminating key, 162 

Test, loop, 119 

TEXT file, 60, 61, 224, 237, 250, 289-292 

TEXT file, memory requirements, 331 

TEXT-to-BASIC transformation, 290 

Threshold, overflow, 182 

Threshold, underflow, 99, 341 
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Time 
base, 17 
error correction, 265-266 
of day, 285, 286 
setting, 264-266 
string, 286 
Timeout, automatic, 153 
Timer, 195, 196, 201-203 
Timer, suspended during input, 153 
Tone, 28 
Track, magnetic card, 36, 226, 296 
Trailing blank, 63 
Transfer, program execution, 199, 200, 201-203 
Transferring execution, 129-132 
Transforming files, 289-292 
Trap, 150, 378, 339 
IEEE, 149 
math, 248 
math exceptions, 72, 339, 340 
OVF, 142 
program errors, 197 
settings, 169 
underflow, 189 
values, 293, 294 
Trigonometric functions, spellings, 5 
Truncated string, 142 
Turn off, 195, 196 
Typing aid, 70, 111 
U 
Unary operator, 308, 309 
UHASSIGHED, 111 
Unconditional branching, 135 
Underflow, 108, 295, 339, 393 
exception, 189 
gradual, 341 
threshold, 99, 317, 318, 341 
UNF, 339, 393 
Unlock, 175 
Unordered comparisons (‘?), 343-344 
Unrecoverable error, during transformation, 292 
Unsecured file, 225, 228, 297 
Uppercase, 8, 166 
Uppercase conversion, 298 
User 
annunciator, 299 
flag, 114 
keyboard, 70, 299 
mode, system flag, 299 


User-defined function, 32, 116-117, 279, 315 
calls, memory use, 94, 332 
ending, 94 
precedence, 117 
same name, 117 
suspend execution, 94, 117 
value, 94 
variable, 169 
User-defined key assignments, 299 
V 
Value, parameter passing, 282 
Variable 
array, 315, 316 
assigning, 151-153 
assignments, 234-235 
deleting, 78 
dependent, 179, 180, 218 
independent, 179, 180, 218 
integer, 155-156, 247 
local, 208 
memory requirements, 332 
numeric, 316 
numeric, REAL, 80 
numeric, SHORT, 270 
passing, 31, 32, 33 
real, 79-80, 238-239 
real string, 80 
reference, 235 
reference, memory requirements, 331 
redimensioned, 80 
releasing, 93 
SHORT, 247, 269-270 
simple, 315, 316 
simple, numeric, 270 
string, 81, 316 
string length, 81 
subprogram, local, 283 
subroutine access, 130 
Verifying a card, 56 
Version string, 301 
(View), 111 
during input, 153 
Viewing angle, 54 
Volume flag, 28 
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od 
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Ww 
Warning, 100 
defined, 378 
during transformation, 290, 291-292 
message string, 101 
number, 102 
Warnings, 378-381 
Window, display, 305 
Window, setting, 126 
Workfile, 122 
work file, 91, 48, 191, 227, 228, 243, 290, 290 
Wrap-around, 26 
Write protection, 226, 296 
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Zero, positive and negative, 49, 50 
Zero, sign of, 342 

Zeroes, leading, 133 

Zone, display, 82 
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